Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase

From: Todd Zullinger <tmz@pobox.com>
Date: Mar 12, 2009, 17:09 UTC
Message-ID: <20090312170931.GB19175@inocybe.teonanacatl.org>
In-Reply-To: <49B8EF3E.2070208@drmicha.warpmail.net>

Michael J Gruber wrote:

> Following up on this:
> On Fedora 10, I have asciidoc 8.2.5 and docbook 1.7.4 xsl's. For
> proper man and html doc, I have to set DOCBOOK_XSL_172=Yes but leave
> ASCIIDOC8 unset! I always forget, though (just like the packagers).

Check the fedora git packages in rawhide, we don't set ASCIIDOC8. :)

I experimented with that and found it did not improve things. We are only setting DOCBOOK_XSL_172. Without that, we get the '.ft C' droppings. With it, we get non-ascii characters in various places (where bold should be used to make the (1) notations stand out, for example). This was filed as:

https://bugzilla.redhat.com/show_bug.cgi?id=485161

I didn't add DOCBOOK_XSL_172 to the F-10 packages yet, because I know that it fixes one problem and causes another. Either way, we'd be shipping packages with known brokeness. I chose to stick with keeping the currently broken '.ft C' behavior. Pick your poison. ;)

One of the fedora/red hat folks that works on the xmlto and docbook packages was going to take a look, as I very much don't understand the documentation stack. :/

Anyone who does is very welcome to help find the culprit(s) and help get fixes to the proper places.

-- 
Todd        OpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The worth of a state, in the long run, is the worth of the individuals
composing it.
    -- John Stuart Mill