From: Thomas Lockhart <lockhart@alumni.caltech.edu>
To: The Hermit Hacker <scrappy@hub.org>
Cc: Bruce Momjian <pgman@candle.pha.pa.us>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org
Subject: Re: Man page sections
Date: Sun, 20 Aug 2000 04:34:10 +0000
Message-ID: <399F5FC2.3676627C@alumni.caltech.edu> (raw)
References: <Pine.BSF.4.21.0008200116290.3758-100000@thelab.hub.org>
> > 7 sounds good.
> isn't there a doc on what each section is "meant for"? for instance,
> section 3 is generally where you find language man pages (ie. getopt(),
> printf()) ...
Right. We currently generate man pages for section one (1) for our
"programs" (e.g. createdb, psql) and man pages for section ell (l) for
our SQL language features (the ell section was chosen for historical
reasons; don't know if anyone here knows why but it was what was used
for the original man pages).
I don't think that we have interpreted section 3 as "language"; I think
it is intended for API/interface docs, which btw we do not have in
reference/man pages.
afaik section seven (7) would be most appropriate for SQL language
features.
- Thomas
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: pgsql-docs@postgresql.org
Cc: lockhart@alumni.caltech.edu, scrappy@hub.org, pgman@candle.pha.pa.us, peter_e@gmx.net
Subject: Re: Man page sections
In-Reply-To: <399F5FC2.3676627C@alumni.caltech.edu>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox