Re: [ANNOUNCE] New man pages

From: Thomas Lockhart <lockhart(at)alumni(dot)caltech(dot)edu>
To: Bruce Momjian <maillist(at)candle(dot)pha(dot)pa(dot)us>
Cc: Postgres Hackers List <hackers(at)postgreSQL(dot)org>
Subject: Re: [ANNOUNCE] New man pages
Date: 1999-08-10 03:21:06
Message-ID: 37AF9AA2.367659E7@alumni.caltech.edu
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-announce 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??

> 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...

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California

In response to

Responses

Browse pgsql-announce by date

  From Date Subject
Next Message Bruce Momjian 1999-08-10 03:29:06 Re: [ANNOUNCE] New man pages
Previous Message Bruce Momjian 1999-08-10 03:08:10 Re: [ANNOUNCE] New man pages

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 1999-08-10 03:29:06 Re: [ANNOUNCE] New man pages
Previous Message lamar.owen 1999-08-10 03:19:47 Re: Pronunciation of "PostgreSQL" (was: Re: [HACKERS] New man pages)