New XML-based man page build
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".
Right now, I can only verify that it works on Debian. Installing this
package from sources might be pretty complicated.
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.
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.
On Mon, 2008-11-10 at 13:59 -0300, Alvaro Herrera wrote:
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.
On Fedora, package is called docbook-2X , and I had to build the docs
with:
make manx DOCBOOK2MAN=/usr/bin/db2x_docbook2man
Regards,
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org
Devrim GÜNDÜZ wrote:
On Fedora, package is called docbook-2X , and I had to build the docs
with:make manx DOCBOOK2MAN=/usr/bin/db2x_docbook2man
I have added a configure check so that this should work out of the box now.
On Wed, 2008-11-26 at 13:32 +0200, Peter Eisentraut wrote:
make manx DOCBOOK2MAN=/usr/bin/db2x_docbook2man
I have added a configure check so that this should work out of the box
now.
Thanks.
--
Devrim GÜNDÜZ, RHCE
devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr
http://www.gunduz.org