public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alvaro Herrera <[email protected]>
To: Peter Eisentraut <[email protected]>
Cc: [email protected]
Subject: Re: New XML-based man page build
Date: Mon, 10 Nov 2008 13:59:38 -0300
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

Peter Eisentraut wrote:
> Following up to the recent discussion that our man page build is weird,  
> ancient, and only works with patched tools, I have implemented support  
> for using a newer toolchain based on docbook2x(.sf.net).  You can try it  
> out by installing docbook2x and running "make manx".

I just tried it and it works great.  This is also Debian so I can't say
how hard it is to install docbook2x.

> The build works nicely and quickly, and if we fix up a few small  
> formatting artifacts and sort out the installation issues, we could  
> switch to using this as our standard build method.

What artifacts do you see?  The only one I can find is that in SEE ALSO
the references to other man pages look like this:

SEE ALSO
       ALTER TEXT SEARCH CONFIGURATION(), DROP TEXT SEARCH CONFIGURATION()

We should replace the spaces with _ and add the "l" section in parens.

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
The PostgreSQL Company - Command Prompt, Inc.

view thread (5+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected]
  Subject: Re: New XML-based man page build
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox