Re: .ft tag in man

From: Todd Zullinger <tmz@pobox.com>
Date: Jan 14, 2009, 06:45 UTC
Message-ID: <20090114064510.GZ18365@inocybe.teonanacatl.org>
In-Reply-To: <7veiz678m2.fsf@gitster.siamese.dyndns.org>

Junio C Hamano wrote:

Show 13 quoted lines

> bill lam <cbill.lam@gmail.com> writes:
>
>> The diagram in man contain some .ft tag, eg inside
>> PAGE=less git help rebase
>> it contains
>>
>>            .ft C
>>                      A---B---C topic
>>                     /
>>                D---E---F---G master
>>            .ft
>
> No, I do not see that neither on my Debian nor on k.org's FC 9.

I began seeing this on Fedora 10. Defining DOCBOOK_XSL_172 fixed that issue, but seems to have caused another. :/

For example, in git-diff.1, without DOCBOOK_XSL_172, I see:

               .ft C
               $ git diff            (1)
               $ git diff --cached   (2)
               $ git diff HEAD       (3)
               .ft

With DOCBOOK_XSL_172, I get this:

               $ git diff            ▓fB(3)▓fR
               $ git diff --cached   ▓fB(2)▓fR
               $ git diff HEAD       ▓fB(3)▓fR

The '.ft' problem is gone, but '\fB' and '\fR' are replaced by '▓fB' and '▓fR', respectively. The paragraphs that follow such a list of commands show more ugliness:

           ⌂sp ▓fB1. ▓fRChanges in the working tree not yet staged for the
           next commit.  ⌂br ▓fB2. ▓fRChanges between the index and your
           last commit; what you would be committing if you run "git commit"
           without "-a" option.  ⌂br ▓fB3. ▓fRChanges in the working tree
           since your last commit; what you would be committing if you run
           "git commit -a" ⌂br

Defining ASCIIDOC8 seems to have no effect on this problem.

> Perhaps you are using different version of asciidoc/docbook/xmlto
> toolchain?

On Fedora 10, these are the versions:

asciidoc-8.2.5-2.fc9 docbook-dtds-1.0-41.fc10 docbook-style-xsl-1.74.0-4.fc10 xmlto-0.0.21-2.fc10

Fedora 9 has:

asciidoc-8.2.5-2.fc9 docbook-dtds-1.0-38.fc9 docbook-style-xsl-1.73.2-10.fc9 xmlto-0.0.20-3.fc9

-- 
Todd        OpenPGP -> KeyID: 0xBEAF0CE3 | URL: www.pobox.com/~tmz/pgp
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Once ... in the wilds of Afghanistan, I lost my corkscrew, and we were
forced to live on nothing but food and water for days.
    -- W.C. Fields