Red Hat Bugzilla – Bug 826139
docbook2man escapes double-quotes in headings incorrectly
Last modified: 2013-03-03 20:30:01 EST
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 . Double-quote character in macro argument has to be replaced by double quote glyph \(dq or has to be doubled .
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.
Version-Release number of selected component (if applicable):
(and probably all others)
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
<INCLUDE IGNORE_MISSING= NO">"
This is not a bug in groff:
Created attachment 587464 [details]
Thanks for the report and patch, Honza.
Should be fixed by http://lists.fedoraproject.org/pipermail/scm-commits/2012-May/787200.html - docbook-utils-0.6.14-31.fc18 -> closing RAWHIDE.
Any plans to backport the fix for f17?
I'll do an update for f16/f17 today...
docbook-utils-0.6.14-30.fc16 has been submitted as an update for Fedora 16.
docbook-utils-0.6.14-31.fc17 has been submitted as an update for Fedora 17.
docbook-utils-0.6.14-30.fc16 has been pushed to the Fedora 16 stable repository. If problems still persist, please make note of it in this bug report.
docbook-utils-0.6.14-31.fc17 has been pushed to the Fedora 17 stable repository. If problems still persist, please make note of it in this bug report.