On Sat, Mar 30, 2019 at 02:00:14PM -0400, Todd Zullinger wrote: > Thanks for the very useful docbook5/xmlto details! > > The hard-coded use of the non-namespaced stylesheets in > xmlto is unfortunate. I hadn't gotten far enough along to > run into that limitation of xmlto, so many thanks for saving > me from finding it myself. I'm sure it would have taken me > far longer. > > If it turns out that docbook5 causes us more pain than it's > worth, I suppose we could choose to use the builtin manpage > backend when using asciidoctor >= 2. I suspect this will be the easiest way forward. If we produce semantically equivalent manpages, then this is also a lot nicer for people who would prefer not to have a full XML toolchain installed. > Or we could see about adding a docbook45 converter, which > upstream noted as a possibility in the ticketĀ¹ which dropped > docbook45 by default. Another possibility, depending on how responsive the xmlto upstream is, is to add some sort of DocBook 5 support to it. This shouldn't be terribly difficult, although we'd have to disable validation. DocBook 5 uses RELAX NG, and libxml2/xmllint's support for this has some bugs, such that it will mark some valid documents using complex interleaves as invalid. Still, if this is the direction we want to go, I have no problem adding this support. Since we'd have a quite new Asciidoctor and a new xmlto, distros should have both around the same time. -- brian m. carlson: Houston, Texas, US OpenPGP: https://keybase.io/bk2204