Re: [ANNOUNCE] New man pages

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

> Bruce Momjian wrote:
> >
> > > All information
> > > from those man pages appears somewhere else in the new docs; usually
> > > in the reference pages but sometimes in a more suitable place.
> > Great. Good job.
>
> Thanks. So, at the moment we have man pages for section one (1) and
> section ell (l). Is this the right section numbering for the future?
> How did we choose the "ell"? Should we consider having some utilities

It is very confusing. I think they chose 'l' for language. Does
someone want to suggest a better section number. Maybe just put them
all in 1.

> like initdb documented in, say, section eight (8)? How about having
> sections like one-sql (1sql) or something similar?

Oh, I get it. Can everyone handle multi-character man sections?

>
> It's easy to move things around, and I'm wondering if the current
> scheme works for people. I don't have a strong opinion on this...
>

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.

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

In response to

Responses

Browse pgsql-announce by date

  From Date Subject
Next Message Thomas Lockhart 1999-08-10 03:21:06 Re: [ANNOUNCE] New man pages
Previous Message Thomas Lockhart 1999-08-10 03:04:37 Re: [ANNOUNCE] New man pages

Browse pgsql-hackers by date

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