Re: Man page sections - Mailing list pgsql-docs

From Thomas Lockhart
Subject Re: Man page sections
Date
Msg-id 399F5FC2.3676627C@alumni.caltech.edu
Whole thread Raw
In response to Re: Man page sections  (The Hermit Hacker <scrappy@hub.org>)
List pgsql-docs
> > 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

pgsql-docs by date:

Previous
From: The Hermit Hacker
Date:
Subject: Re: Man page sections
Next
From: Peter Eisentraut
Date:
Subject: Re: Man page sections