Re: [PATCH] asciidoctor-extensions: provide `<refmiscinfo/>`

From: brian m. carlson <sandals@crustytoothpaste.net>
Date: Mar 30, 2019, 21:04 UTC
Message-ID: <20190330210457.GC12419@genre.crustytoothpaste.net>
In-Reply-To: <20190330180014.GB4047@pobox.com>

On Sat, Mar 30, 2019 at 02:00:14PM -0400, Todd Zullinger wrote:

Show 11 quoted lines

> 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