Skip site navigation (1) Skip section navigation (2)

Re: A smaller default postgresql.conf

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: pgsql-hackers(at)postgresql(dot)org
Cc: Alvaro Herrera <alvherre(at)commandprompt(dot)com>, David Fetter <david(at)fetter(dot)org>
Subject: Re: A smaller default postgresql.conf
Date: 2008-08-21 16:10:35
Message-ID: 200808211910.37524.peter_e@gmx.net (view raw or flat)
Thread:
Lists: pgsql-hackers
Alvaro Herrera wrote:
> So, did anyone else try to generate man pages?

Before we get too excited here:  Man pages are only built/buildable from 
<refentry> elements.  You can't just go and convert some arbitrary section or 
chapter into a man page.  So there is a bit of work and invention necessary 
here.  Offhand I'd try writing an XSLT script that can convert the chapter to 
the required refentry structure and go from there.

> I did "make man" and ran into several issues.
>
> The first is that D2MDIR needs to be specified manually.  I assume this
> is how everyone does it, so I did that.

True, because there is no standard place for it.  And throughout most of 
history, you needed a locally built version anyway.

> The second is that the Perl script as packaged by Debian doesn't work --
> it is missing a handful of HTML entities, and it errors out before
> generating anything.

The packaging situation on Debian is quite weird.  (See also 
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=275715)  I suggest you 
download docbook2man-sgmlspl-1.0.tar.gz from upstream (docbook2x.sf.net) and 
install it (configure, make, make install).  Then with

make man D2MDIR=/usr/local/bin

I get plausible output.  There are indeed a few entities missing, but I think 
that is not really important because they appear in the areas that are not 
converted to the man pages.

If there is interest in sorting out this tools mess, then I suggest also 
exploring converting the entire thing to use the new XML-based docbook2x 
tools.

In response to

pgsql-hackers by date

Next:From: Peter EisentrautDate: 2008-08-21 16:17:55
Subject: Re: [FINALLY] the TODO list has migrated to Wiki
Previous:From: D'Arcy J.M. CainDate: 2008-08-21 15:57:19
Subject: Proposal: new border setting in psql

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group