[xml/sgml-pkgs] Bug#442782: docbook2x: uses incorrect syntax for man page preprocessor declarations

[Colin Watson]

Package: docbook2x
Version: 0.8.8-4
Severity: normal
Tags: patch

docbook2x-man generates preprocessor declarations such as the following:

  .\" -*- coding: us-ascii -*-

This type of declaration bootstraps off the preprocessor declaration
mechanism that's been supported in manual pages for a while.
Conventionally (see 'info groff'), these use '\" rather than .\" (the
technical difference is that using ' as the control character suppresses
a break, which is not very relevant on the first line of a manual page,
but it's conventional anyway). Current man-db only supports '\" for
these declarations, not .\". As the upstream maintainer of man-db, I'm
going to make it support .\" too for encoding declarations ONLY, but I
consider docbook2x-man's current behaviour to be a bug.

I initially noticed this for encoding declarations such as the above,
but in fact it applies to all preprocessor declarations generated by
docbook2x-man. Furthermore, the current code outputs two lines if both
special preprocessors and an encoding are being declared, which is also
not supported by man-db (and I don't plan to change this at the moment).
These should be consolidated onto a single line.

The attached patch fixes all this (in full for the Perl processor, and
at least in part for the XSLT code). Please apply.

Thanks,

-- 
Colin Watson                                       [cjwatson at debian.org]
-------------- next part --------------
A non-text attachment was scrubbed...
Name: docbook2x-preprocessors.diff
Type: text/x-diff
Size: 2513 bytes
Desc: not available
Url : http://lists.alioth.debian.org/pipermail/debian-xml-sgml-pkgs/attachments/20070916/9473e71c/attachment.diff