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

From Bruce Momjian
Subject Re: [ANNOUNCE] New man pages
Date
Msg-id 199908100329.XAA15133@candle.pha.pa.us
Whole thread Raw
In response to Re: [ANNOUNCE] New man pages  (Thomas Lockhart <lockhart@alumni.caltech.edu>)
List pgsql-hackers
> > Oh, I get it.  Can everyone handle multi-character man sections?
> 
> That is how, for example, the X system does their man pages. There are
> sections "1x", etc. Except that now that I look on my RH linux system
> they are squirreled away in /usr/X11/man/man1/, etc so I must have
> seen that on another system. Perhaps my old Alpha boxes??

SCO does that.  Section 1M.

> 
> > I would like to use existing sections, rather than do our own.  I found
> > I had to modify the man page search to look in a manl, and others may
> > have the same problem.
> 
> Yes, that is a consideration. It is easy to automate adding a new
> section (like "1sql" or "1p" or ??) for packages, but is something the
> admin needs to remember to do on a from-source installation. 
> 
> otoh, it does eliminate the possibility of man page pollution if we
> manage to have the same man page name as some other existing page.
> *That* would be a bad thing. And in general adding ~75 man pages to
> existing sections is a pretty big load...

Oh, good point.  How do we get around that.  I don't see another
existing section that looks appropriate for SQL commands.

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


pgsql-hackers by date:

Previous
From: Thomas Lockhart
Date:
Subject: Re: [ANNOUNCE] New man pages
Next
From: Thomas Lockhart
Date:
Subject: Re: RPMs (was Pronunciation of "PostgreSQL")