Man pages for 8.0

Lists: pgsql-docs
From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: pgsql-docs(at)postgresql(dot)org
Subject: Man pages for 8.0
Date: 2004-10-09 18:31:06
Message-ID: 200410092031.06343.peter_e@gmx.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

I've built man pages for 8.0 and put them at the usual place
(/pub/dev/doc, not sure why they don't show up on the ftp server,
though). We have the problem, however, that the man pages now have
many links to other parts of the documentation, which cannot be
represented well in a man page. The built man pages are currently full
of things like

"""
Sets the default locale for the database cluster. If this
option is not specified, the locale is inherited from the
environment that \fBinitdb\fR runs in. Locale
support is described in [XRef to LOCALE].
"""

Not sure how to resolve that. Ideas?

--
Peter Eisentraut
http://developer.postgresql.org/~petere/


From: Josh Berkus <josh(at)agliodbs(dot)com>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Man pages for 8.0
Date: 2004-10-11 17:00:23
Message-ID: 200410111000.23685.josh@agliodbs.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Peter,

> """
> Sets the default locale for the database cluster. If this
> option is not specified, the locale is inherited from the
> environment that \fBinitdb\fR runs in. Locale
> support is described in [XRef to LOCALE].
> """

I see now why you didn't want me to make runtime.sgml full of XRefs.

--
Josh Berkus
Aglio Database Solutions
San Francisco


From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Josh Berkus <josh(at)agliodbs(dot)com>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Man pages for 8.0
Date: 2004-10-11 17:32:50
Message-ID: 200410111932.50253.peter_e@gmx.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

Josh Berkus wrote:
> I see now why you didn't want me to make runtime.sgml full of XRefs.

Umm, no, I have no problem with xrefs in runtime.sgml. The issue here
is having xrefs from parts that are converted to man pages linking to
parts that do not become parts of any man pages.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/