[xml/sgml-pkgs] Bug#821235: man: apostrophe/single quote in title results in undefined macro \*(AQ

[Simon McVittie]

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