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.