Re: [DOCS] New man pages - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: [DOCS] New man pages
Date
Msg-id 199908061502.LAA08349@candle.pha.pa.us
Whole thread Raw
In response to New man pages  (Thomas Lockhart <lockhart@alumni.caltech.edu>)
List pgsql-hackers
> 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....}]
[havinghaving-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,
Pennsylvania19026
 


pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: [HACKERS] 6.5.2
Next
From: Thomas Lockhart
Date:
Subject: Re: [DOCS] New man pages