From: Bruce Momjian <maillist@candle.pha.pa.us>
To: Thomas Lockhart <lockhart@alumni.caltech.edu>
Cc: Postgres Hackers List <hackers@postgreSQL.org>
Cc: Postgres Documentation List <docs@postgreSQL.org>
Subject: Re: [DOCS] New man pages
Date: Fri, 6 Aug 1999 11:02:20 -0400 (EDT)
Message-ID: <199908061502.LAA08349@candle.pha.pa.us> (raw)
In-Reply-To: <37A9A55B.2FA1A924@alumni.caltech.edu>
> I've posted a tarball of new man pages at
>
> ftp://postgresql.org/pub/doc/man.tar.gz
>
> I *think* these are ready for prime time, or close to it. They are
> generated completely automatically from the sgml sources, using some
> patched perl utilities. I'll try to post the complete set of docs
> tools on the ftp site sometime soon.
>
> Note that there are a few more man pages than were available in the
> original versions, and that *all* information in the original man
> pages appears in the new ones (or somewhere in the other docs).
>
> I haven't yet updated the cvs tree to contain these new man pages.
> Please look through the tarball and report any problems you see, if
> you have any interest in the man page issue. Also, please report if
> they look OK, so I know *someone* looked at them ;)
I looked at the new pages, and they looked very good, much better than I
thought they would. The only problem was the display of the command
syntax was wrapped rather than being one operator per line:
select [distinct [on attr_name]]
expression1 [as attr_name-1]
{, expression-1 [as attr_name-i]}
[into [temp] [table] classname]
[from from-list]
[where where-clause]
[group by attr_name1 {, attr_name-i....}]
[having having-clause]
became:
select [distinct [on attr_name]] expression1 [as attr_name-1]
{, expression-1 [as attr_name-i]} [into [temp] [table] classname]
[from from-list] [where where-clause] [group by attr_name1
{, attr_name-i....}] [having having-clause]
Which is almost unreadable.
--
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, Pennsylvania 19026
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: maillist@candle.pha.pa.us, lockhart@alumni.caltech.edu, hackers@postgreSQL.org, docs@postgreSQL.org
Subject: Re: [DOCS] New man pages
In-Reply-To: <199908061502.LAA08349@candle.pha.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox