Re: assorted documentation errors

Rich Morin writes:

> I have been looking over the PostgreSQL manual pages and have noted a
> number of formatting problems.  Unfortunately, as the DocBook source
> code does not seem to be in the distribution, I have no way of knowing
> where these problems originated.  In any case, here is a summary:

You seem to be using the wrong distribution then.

> createdb.1, createlang.1, createuser.1, dropdb.1, droplang.1, etc.
>
>    In many places where code and output examples are being given, the
>    font used is proportional.  If a monospace font were used, the code
>    would stand out better and the output would line up correctly.

Unfortunately, I'm kind of at a loss of how to do this sort of thing on
troff.  I'm glad I got reasonably looking man (terminal) output; print
output is not really planned.  (You can use the provided Postscript
version of the Reference Manual for that.)

You can follow the link at
http://www.ca.postgresql.org/~petere/docbook2man.html and see if you can
fix the code yourself.  Look in docbook2man-spec.pl at function
verbatim_start.

> pg_restore.1
>
>    In the NAME entry, there is a missing space in "created bypg_dump".

Probably need to hack the spec file even more.  There's already a lot of
that just to get the synopsis lines look okay.

> If you know how this problem might be fixed, list the solution below:
> ---------------------------------------------------------------------
>
> Edit the original files and/or fix the conversion script.

Generations of programmers have tried that and failed. :-(

--
Peter Eisentraut   peter_e@gmx.net   http://funkturm.homeip.net/~peter