From: Todd Zullinger <tmz@pobox.com>
Date: Thu, 12 Mar 2009 17:09:32 GMT
Subject: Re: git doc build failure on OS X 10.5.6 (Leopard) during xmlto phase
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