Created attachment 587463 [details]
source files for reproduction

Description of problem:

If the title in the input SGML document contains double-quote character, it is escaped incorrectly and the output manual page is damaged.

Currently, the docbook2man-spec.pl script uses zero-width-character \& which is added before the double quote character. The purpose of zero-width-character is completely different [1]. Double-quote character in macro argument has to be replaced by double quote glyph \(dq or has to be doubled [2].

In case of docbook2man-spec.pl, the second approach is better, otherwise the order of the operations would have to be changed. The string is being converted to uppercase after the escaping, which would break the double quote glyph.


[1] http://www.gnu.org/software/groff/manual/html_node/Ligatures-and-Kerning.html
[2] http://www.gnu.org/software/groff/manual/html_node/Request-and-Macro-Arguments.html


Version-Release number of selected component (if applicable):
docbook-utils-0.6.14-30.fc17.noarch
(and probably all others)


How reproducible:
Take a look at "man 5 fonts-conf", which is damaged. I'm attaching the source SGML files to reproduce and validate the fix.


Steps to Reproduce:
1. decompress the archive
2. run: docbook2man fontconfig-user.sgml
3. run: man ./fonts-conf.5 
  
Actual results:

...
<INCLUDE IGNORE_MISSING= NO">"
...


Expected results:

...
<INCLUDE IGNORE_MISSING="NO">
...


Additional info:

This is not a bug in groff:
https://bugzilla.redhat.com/show_bug.cgi?id=797005