Re: groff .ft command use in asciidoc

From: Drew Northup <drew.northup@maine.edu>
Date: Nov 19, 2010, 20:34 UTC
Message-ID: <1290198893.13785.68.camel@drew-northup.unet.maine.edu>
In-Reply-To: <20101119175424.GA13276@sigill.intra.peff.net>

On Fri, 2010-11-19 at 12:54 -0500, Jeff King wrote:

Show 37 quoted lines

> On Wed, Nov 17, 2010 at 04:48:29PM +0100, Andi Kleen wrote:
> 
> > On Wed, Nov 17, 2010 at 09:38:55AM -0500, Jeff King wrote:
> > > On Wed, Nov 17, 2010 at 04:15:16AM -0600, Jonathan Nieder wrote:
> > > Andi, I would be curious to hear which asciidoc and docbook-xsl versions
> > > you are using.
> > 
> > I see this with the git rpms in opensuse 11.3 which I didn't build.
> > But presumably it's built with asciidoc 8.4.5-5.1 and 1.75.2-7.1
> 
> Thanks. I think technically that is a bug in opensuse's packaging, as
> they are not setting the right knobs for their version. However, I think
> these days we can make it easier for them. Perhaps it is time to apply
> this:
> 
> -- >8 --
> Subject: [PATCH] docs: default to more modern toolset
> 
> When the ASCIIDOC8 and ASCIIDOC_NO_ROFF knobs were built,
> many people were still on asciidoc 7 and using older
> versions of docbook-xsl. These days, even the almost
> 2-year-old Debian stable needs these knobs turned.
> 
> So let's turn them by default. The new knobs ASCIIDOC7 and
> ASCIIDOC_ROFF can be used to get the old behavior if people
> are on older systems.
> 
> Signed-off-by: Jeff King <peff@peff.net>
> ---
> These defaults work on Debian stable and further. It sounds like
> opensuse 11.3, too. I don't know about Fedora, but I suspect they are at
> least as far along as Debian stable.
> 
> RHEL5 has asciidoc8, but docbook-xsl 1.69, which means it still needs
> ASCIIDOC_ROFF enabled. RHEL6 is just out last week. So we are
> technically breaking at least RHEL5 people (along with anybody with
> ancient systems) until they tweak their knobs.

Once I imported the DocBook XML XSL 4.5 files into my local cache it seemed to make the man pages just fine on my RHEL5 machine even with the posted patch applied.

[root@host ~]# rpm -qi asciidoc Name : asciidoc Relocations: (not relocatable) Version : 8.6.3 Vendor: Dag Apt Repository, http://dag.wieers.com/apt/ Release : 1.el5.rf Build Date: Thu 18 Nov 2010 08:35:22 AM EST ... [root@host ~]# rpm -qi docbook-utils Name : docbook-utils Relocations: (not relocatable) Version : 0.6.14 Vendor: Red Hat, Inc. Release : 5.1 Build Date: Wed 12 Jul 2006 03:55:00 AM EDT

I didn't inspect each and every one for errors, but I didn't see any problems in the ones I did look at.

-- 
-Drew Northup N1XIM
   AKA RvnPhnx on OPN
________________________________________________
"As opposed to vegetable or mineral error?"
-John Pescatore, SANS NewsBites Vol. 12 Num. 59