Re: [HACKERS] Re: [ANNOUNCE] New man pages - Mailing list pgsql-hackers

From Tom Lane
Subject Re: [HACKERS] Re: [ANNOUNCE] New man pages
Date
Msg-id 5195.934297292@sss.pgh.pa.us
Whole thread Raw
In response to Re: [HACKERS] Re: [ANNOUNCE] New man pages  (Thomas Lockhart <lockhart@alumni.caltech.edu>)
List pgsql-hackers
Thomas Lockhart <lockhart@alumni.caltech.edu> writes:
>> On BSD, section 8 seems to contain admin programs (the stuff HPUX
>> keeps in 1m).  I don't see any sections on either my HPUX box or
>> a nearby BSD box that contain pages for individual keywords of
>> a programming language...

> Oliver uses section 7 (miscellaneous...) for SQL commands, which seems
> to be the right choice given the guidelines for Debian, RedHat, FHS,
> and my imprecise impression of what is typical.

7 works for me; there's not much there except a few kernel device
driver manpages on my box.

> Is there any concern about using "l" (ell) for the section
> discriminator?
> So, I'll count you as not objecting to sections "1l" (one-ell) and
> "7l" (seven-ell), ok?

How about "s" for "SQL"?  ell is too easily mistaken for one; we'd
have to put "no, it's not section eleven" in the FAQ ...

> btw, on my Solaris boxes MANPATH is worse than useless; if you specify
> it then none of the other paths mentioned in /etc/man.config (or
> wherever that is on Solaris) get used. So you have to recreate all of
> the default MANPATH settings in your environment variable. Of course,
> now that I've whined about this perhaps someone knows a way around
> this?

Er, why not "MANPATH=/usr/local/pgsql/man:$MANPATH" ?
        regards, tom lane


pgsql-hackers by date:

Previous
From: Brook Milligan
Date:
Subject: Re: [HACKERS] Re: [ANNOUNCE] New man pages
Next
From: "Oliver Elphick"
Date:
Subject: Re: [HACKERS] Re: [ANNOUNCE] New man pages