Thread: Man page sections

Man page sections

From
Peter Eisentraut
Date:
I think we should make the man pages for the SQL commands section 7
("miscellaneous"), rather than "l" (ell). The latter is not a standard or
portable concept.


--
Peter Eisentraut                  Sernanders väg 10:115
peter_e@gmx.net                   75262 Uppsala
http://yi.org/peter-e/            Sweden


Re: Man page sections

From
Thomas Lockhart
Date:
> I think we should make the man pages for the SQL commands section 7
> ("miscellaneous"), rather than "l" (ell). The latter is not a standard or
> portable concept.

Yeah, that was always a bit strange to me. Any objections to section 7?
The man page tool can do this easily...

                     - Thomas

Re: Man page sections

From
Bruce Momjian
Date:
> > I think we should make the man pages for the SQL commands section 7
> > ("miscellaneous"), rather than "l" (ell). The latter is not a standard or
> > portable concept.
>
> Yeah, that was always a bit strange to me. Any objections to section 7?
> The man page tool can do this easily...

7 sounds good.

--
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 853-3000
  +  If your life is a hard drive,     |  830 Blythe Avenue
  +  Christ can be your backup.        |  Drexel Hill, Pennsylvania 19026

Re: Man page sections

From
The Hermit Hacker
Date:
On Sat, 19 Aug 2000, Bruce Momjian wrote:

> > > I think we should make the man pages for the SQL commands section 7
> > > ("miscellaneous"), rather than "l" (ell). The latter is not a standard or
> > > portable concept.
> >
> > Yeah, that was always a bit strange to me. Any objections to section 7?
> > The man page tool can do this easily...
>
> 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()) ...



Re: Man page sections

From
Thomas Lockhart
Date:
> > 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

Re: Man page sections

From
Peter Eisentraut
Date:
The Hermit Hacker writes:

> 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()) ...

1 - User commands
2 - System calls
3 - C library functions
4 - Devices
5 - File formats
6 - Games
7 - Miscellaneous
8 - System administration commands

Doesn't make sense to me either...

--
Peter Eisentraut                  Sernanders väg 10:115
peter_e@gmx.net                   75262 Uppsala
http://yi.org/peter-e/            Sweden


Re: Man page sections

From
sales@gpz.fi
Date:
Peter Eisentraut wrote:
>
> The Hermit Hacker writes:
>
> > 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()) ...
>
> 1 - User commands
> 2 - System calls
> 3 - C library functions
> 4 - Devices
> 5 - File formats
> 6 - Games
> 7 - Miscellaneous
> 8 - System administration commands

This is for BSD, in SysV 7 is for devices.
l is usually for local and n for new.
(UNIX System Administration Handbook. 2nd ed., E. Nemeth et al.)

> Doesn't make sense to me either...
>
> --
> Peter Eisentraut                  Sernanders vÄg 10:115
> peter_e@gmx.net                   75262 Uppsala
> http://yi.org/peter-e/            Sweden

--
Vladimir Tchoukharev