pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
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



view thread (9+ messages)  latest in thread

Message-ID: <199908061502.LAA08349@candle.pha.pa.us>
Permalink:  ../199908061502.LAA08349@candle.pha.pa.us/
Also on:    postgresql.org/message-id/199908061502.LAA08349@candle.pha.pa.us

 · 

reply

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