From: Jeff King <peff@peff.net>
Date: Wed, 17 Nov 2010 14:38:55 GMT
Subject: Re: groff .ft command use in asciidoc
Message-ID: <20101117143855.GA1987@sigill.intra.peff.net>
In-Reply-To: <20101117101516.GA12416@burratino>

On Wed, Nov 17, 2010 at 04:15:16AM -0600, Jonathan Nieder wrote:

> This is in my opinion a bug: unless you use ASCIIDOC_NO_ROFF, git's
> asciidoc.conf will include raw roff directives in the docbook markup
> it generates.  And then docbook will escape the periods, producing
> the output you see.

IIRC, that depends very much on the versions of asciidoc and docbook you
have. Once upon a time, not setting ASCIIDOC_NO_ROFF was required for
sane output.

Andi, I would be curious to hear which asciidoc and docbook-xsl versions
you are using.

> I think the only reason this is not the default is that no one has
> tested it with old DocBook XSL versions, but I'm not sure.
> Documentation/Makefile has some notes about this.

At the time those knobs came into being, the defaults were set for
then-current versions of the software. I suspect ASCIIDOC8 and
ASCIIDOC_NO_ROFF should be the default these days.

-Peff