Thread: Man page sections
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
> 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
> > 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
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()) ...
> > 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
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
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