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

From Oliver Elphick
Subject Re: [HACKERS] Re: [ANNOUNCE] New man pages
Date
Msg-id 199908101131.MAA07545@linda.lfix.co.uk
Whole thread Raw
In response to Re: [ANNOUNCE] New man pages  (Thomas Lockhart <lockhart@alumni.caltech.edu>)
List pgsql-hackers
Thomas Lockhart wrote: >> Oh, I get it.  Can everyone handle multi-character man sections? > >That is how, for example,
theX system does their man pages. There are >sections "1x", etc. Except that now that I look on my RH linux system
>theyare squirreled away in /usr/X11/man/man1/, etc so I must have >seen that on another system. Perhaps my old Alpha
boxes??
 
Pages from multi-character sections are stored in the directory for the
first character.  For instance: /usr/man/man7/select.7l.gz
 >> I would like to use existing sections, rather than do our own.  I found >> I had to modify the man page search to
lookin a manl, and others may >> have the same problem. 
 
For Debian, I have relocated the SQL pages to section 7l and commands such
as psql and createuser go in section 1.  Policy requires me to use one of
the numbered sections (1-8), though I can use a suffix to ensure uniqueness.

On Debian GNU/Linux, the sections are:
1 User commands
2 System calls
3 Library routines
4 Devices
5 File formats
6 Games
7 Miscellaneous
8 System administration

... >otoh, it does eliminate the possibility of man page pollution if we >manage to have the same man page name as some
otherexisting page.
 

As of course we do; for example, select is also in section 2.
 >*That* would be a bad thing. And in general adding ~75 man pages to >existing sections is a pretty big load...

I'm not sure that's much of a problem. These are the figures from my
system for /usr/man, /usr/share/man, /usr/X11R6/man and /usr/local/man
combined:

Section   Count
1          2258
2           236
3          6554
4            39
5           236
6            26
7           128
8           517

--      Vote against SPAM: http://www.politik-digital.de/spam/                ========================================
Oliver Elphick                                Oliver.Elphick@lfix.co.uk
Isle of Wight                              http://www.lfix.co.uk/oliver              PGP key from public servers; key
ID32B8FAA1                ========================================    "If ye abide in me, and my words abide in you, ye
shall    ask what ye will, and it shall be done unto you."                                          John 15:7 
 




pgsql-hackers by date:

Previous
From: José Soares
Date:
Subject: another DECIMAL problem
Next
From: Thomas Lockhart
Date:
Subject: Re: [HACKERS] Re: [ANNOUNCE] New man pages