Package: docbook-xsl
Version: 1.79.1+dfsg-1
Severity: normal
The ostree package has man pages written in Docbook XML and processed into
man pages via docbook.xsl. A couple of them have apostrophes/single quotes
(U+0027 APOSTROPHE) in a section's title:
<refsect1>
<title>'Generate' Options</title>
and
<refsect1>
<title>'Add' Options</title>
In the man page output, this looks like:
.SH "\*(AQADD\*(AQ OPTIONS"
.PP
\fB\-\-set\fR="KEY=VALUE"
leading to these errors from man, which are passed on by lintian:
% man --warnings /usr/share/man/man1/ostree-remote.1.gz >/dev/null
<standard input>:62: warning: macro `AQ' not defined
The preamble generated by docbook-xsl does define a macro named Aq
to represent apostrophes, if I'm reading it correctly (I don't really
understand the finer points of this typesetting language though).
I suspect that the bug might be that U+0027 is replaced with \*(Aq
before case-folding the heading to upper-case. If my theory is right,
the other way round would work, i.e. docbook-xsl should upper-case the
text first, and replace U+0027 with \*(Aq afterwards.
Regards,
S
-- System Information:
Debian Release: stretch/sid
APT prefers unstable
APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1,
'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386
Kernel: Linux 4.5.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_GB.utf8, LC_CTYPE=en_GB.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
Versions of packages docbook-xsl depends on:
ii xml-core 0.13+nmu2
Versions of packages docbook-xsl recommends:
ii docbook-xml 4.5-7.3
Versions of packages docbook-xsl suggests:
pn dbtoepub <none>
ii docbook-xsl-doc-html [docbook-xsl-doc] 1.78.1-1
pn docbook-xsl-saxon <none>
ii fop 1:2.1-3
ii libsaxon-java 1:6.5.5-10
ii libxalan2-java 2.7.1-9
pn libxslthl-java <none>
pn xalan <none>
-- no debconf information
