Bug#1082554: docbook-xml: apostrophe in man page section header gets converted into invalid macro

[Jonathan Kamens <jik@kamens.us>]

Package: docbook-xml
Version: 4.5-13
Severity: normal

1. Save the attached file as sample.xml.
2. Run `xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl sample.xml`
3. Observe that the output file sample.1 has this in it: `.SH "FOO\*(AQBAR"`

That should be `\*(Aq` rather than `\(*AQ`. The problem here is that
first the stylesheet converts the apostrophe in the XML into `\*(Aq`,
and then it upper-cases the entire header, rendering the macro
invalid.

Easiest fix might be to define AQ macro in addition to Aq macro
in define.portability.macros template in other.xsl.

-- System Information:
Debian Release: trixie/sid
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 6.10.9-amd64 (SMP w/8 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages docbook-xml depends on:
ii  sgml-base  1.31
ii  sgml-data  2.0.11+nmu1
ii  xml-core   0.19

docbook-xml recommends no packages.

Versions of packages docbook-xml suggests:
pn  docbook           <none>
pn  docbook-defguide  <none>
pn  docbook-dsssl     <none>
ii  docbook-xsl       1.79.2+dfsg-7

-- no debconf information