pgsql: Split contrib documentation into extensions and programs

Started by Peter Eisentrautalmost 14 years ago3 messageshackers
Jump to latest
#1Peter Eisentraut
peter_e@gmx.net

Split contrib documentation into extensions and programs

Create separate appendixes for contrib extensions and other server
plugins on the one hand, and utility programs on the other. Recast
the documentation of the latter as refentries, so that man pages are
generated.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/1c882e07da553d792f479beb92b4729a4c0bd8de

Modified Files
--------------
doc/src/sgml/contrib.sgml | 89 ++++++++++++++++++---
doc/src/sgml/docguide.sgml | 9 ++
doc/src/sgml/oid2name.sgml | 64 +++++++++------
doc/src/sgml/pgarchivecleanup.sgml | 106 +++++++++++++-----------
doc/src/sgml/pgbench.sgml | 155 ++++++++++++++++++++---------------
doc/src/sgml/pgstandby.sgml | 135 ++++++++++++++++---------------
doc/src/sgml/pgtestfsync.sgml | 47 ++++++++---
doc/src/sgml/pgtesttiming.sgml | 68 +++++++++++-----
doc/src/sgml/pgupgrade.sgml | 157 ++++++++++++++++++++++--------------
doc/src/sgml/stylesheet-man.xsl | 10 +++
doc/src/sgml/vacuumlo.sgml | 118 +++++++++++++++------------
11 files changed, 597 insertions(+), 361 deletions(-)

#2Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: Peter Eisentraut (#1)
Re: [COMMITTERS] pgsql: Split contrib documentation into extensions and programs

Excerpts from Peter Eisentraut's message of mié may 09 13:54:53 -0400 2012:

Split contrib documentation into extensions and programs

Create separate appendixes for contrib extensions and other server
plugins on the one hand, and utility programs on the other. Recast
the documentation of the latter as refentries, so that man pages are
generated.

I noticed that the pgupgrade manpage doesn't have the titles of each
step in "Usage". Not sure this is a serious problem, but it's different
from the HTML at any rate.

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

#3Peter Eisentraut
peter_e@gmx.net
In reply to: Alvaro Herrera (#2)
Re: [COMMITTERS] pgsql: Split contrib documentation into extensions and programs

On ons, 2012-05-09 at 14:44 -0400, Alvaro Herrera wrote:

Excerpts from Peter Eisentraut's message of mié may 09 13:54:53 -0400 2012:

Split contrib documentation into extensions and programs

Create separate appendixes for contrib extensions and other server
plugins on the one hand, and utility programs on the other. Recast
the documentation of the latter as refentries, so that man pages are
generated.

I noticed that the pgupgrade manpage doesn't have the titles of each
step in "Usage". Not sure this is a serious problem, but it's different
from the HTML at any rate.

Fixed.