pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedMan page sections
7+ messages / 5 participants
[nested] [flat]
* Man page sections
@ 2000-08-19 22:32 Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2000-08-19 22:32 UTC (permalink / raw)
To: pgsql-docs
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Man page sections
@ 2000-08-20 01:13 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 7+ messages in thread
From: Thomas Lockhart @ 2000-08-20 01:13 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
> 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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Man page sections
@ 2000-08-20 03:21 Bruce Momjian <pgman@candle.pha.pa.us>
parent: Thomas Lockhart <lockhart@alumni.caltech.edu>
0 siblings, 1 reply; 7+ messages in thread
From: Bruce Momjian @ 2000-08-20 03:21 UTC (permalink / raw)
To: Thomas Lockhart <lockhart@alumni.caltech.edu>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
> > 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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Man page sections
@ 2000-08-20 04:17 The Hermit Hacker <scrappy@hub.org>
parent: Bruce Momjian <pgman@candle.pha.pa.us>
0 siblings, 2 replies; 7+ messages in thread
From: The Hermit Hacker @ 2000-08-20 04:17 UTC (permalink / raw)
To: Bruce Momjian <pgman@candle.pha.pa.us>; +Cc: Thomas Lockhart <lockhart@alumni.caltech.edu>; Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
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()) ...
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Man page sections
@ 2000-08-20 04:34 Thomas Lockhart <lockhart@alumni.caltech.edu>
parent: The Hermit Hacker <scrappy@hub.org>
1 sibling, 0 replies; 7+ messages in thread
From: Thomas Lockhart @ 2000-08-20 04:34 UTC (permalink / raw)
To: The Hermit Hacker <scrappy@hub.org>; +Cc: Bruce Momjian <pgman@candle.pha.pa.us>; Peter Eisentraut <peter_e@gmx.net>; 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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Man page sections
@ 2000-08-20 09:23 Peter Eisentraut <peter_e@gmx.net>
parent: The Hermit Hacker <scrappy@hub.org>
1 sibling, 1 reply; 7+ messages in thread
From: Peter Eisentraut @ 2000-08-20 09:23 UTC (permalink / raw)
To: The Hermit Hacker <scrappy@hub.org>; +Cc: Bruce Momjian <pgman@candle.pha.pa.us>; Thomas Lockhart <lockhart@alumni.caltech.edu>; pgsql-docs
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
^ permalink raw reply [nested|flat] 7+ messages in thread
* Re: Man page sections
@ 2000-08-21 11:10 sales@gpz.fi
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 7+ messages in thread
From: sales@gpz.fi @ 2000-08-21 11:10 UTC (permalink / raw)
To: pgsql-docs
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
^ permalink raw reply [nested|flat] 7+ messages in thread
end of thread, other threads:[~2000-08-21 11:10 UTC | newest]
Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2000-08-19 22:32 Man page sections Peter Eisentraut <peter_e@gmx.net>
2000-08-20 01:13 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-08-20 03:21 ` Bruce Momjian <pgman@candle.pha.pa.us>
2000-08-20 04:17 ` The Hermit Hacker <scrappy@hub.org>
2000-08-20 04:34 ` Thomas Lockhart <lockhart@alumni.caltech.edu>
2000-08-20 09:23 ` Peter Eisentraut <peter_e@gmx.net>
2000-08-21 11:10 ` sales@gpz.fi
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