From: Bruce Momjian <maillist@candle.pha.pa.us>
Message-Id: <199908061502.LAA08349@candle.pha.pa.us>
Subject: Re: [DOCS] New man pages
In-Reply-To: <37A9A55B.2FA1A924@alumni.caltech.edu> from Thomas Lockhart at
	"Aug 5, 1999 02:53:15 pm"
To: Thomas Lockhart <lockhart@alumni.caltech.edu>
Date: Fri, 6 Aug 1999 11:02:20 -0400 (EDT)
CC: Postgres Hackers List <hackers@postgreSQL.org>,
	Postgres Documentation List <docs@postgreSQL.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit

> 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