public inbox for [email protected]  
help / color / mirror / Atom feed
Man pages for 8.0
3+ messages / 2 participants
[nested] [flat]

* Man pages for 8.0
@ 2004-10-09 18:31  Peter Eisentraut <[email protected]>
  0 siblings, 1 reply; 3+ messages in thread

From: Peter Eisentraut @ 2004-10-09 18:31 UTC (permalink / raw)
  To: 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/




^ permalink  raw  reply  [nested|flat] 3+ messages in thread

* Re: Man pages for 8.0
@ 2004-10-11 17:00  Josh Berkus <[email protected]>
  parent: Peter Eisentraut <[email protected]>
  0 siblings, 1 reply; 3+ messages in thread

From: Josh Berkus @ 2004-10-11 17:00 UTC (permalink / raw)
  To: Peter Eisentraut <[email protected]>; +Cc: 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



^ permalink  raw  reply  [nested|flat] 3+ messages in thread

* Re: Man pages for 8.0
@ 2004-10-11 17:32  Peter Eisentraut <[email protected]>
  parent: Josh Berkus <[email protected]>
  0 siblings, 0 replies; 3+ messages in thread

From: Peter Eisentraut @ 2004-10-11 17:32 UTC (permalink / raw)
  To: Josh Berkus <[email protected]>; +Cc: 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/





^ permalink  raw  reply  [nested|flat] 3+ messages in thread


end of thread, other threads:[~2004-10-11 17:32 UTC | newest]

Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2004-10-09 18:31 Man pages for 8.0 Peter Eisentraut <[email protected]>
2004-10-11 17:00 ` Josh Berkus <[email protected]>
2004-10-11 17:32   ` Peter Eisentraut <[email protected]>

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