pgsql: Split contrib documentation into extensions and programs

Lists: pgsql-committerspgsql-hackers
From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: pgsql-committers(at)postgresql(dot)org
Subject: pgsql: Split contrib documentation into extensions and programs
Date: 2012-05-09 17:54:53
Message-ID: E1SSB6D-0000I6-GS@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-committers pgsql-hackers

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(-)


From: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
To: Peter Eisentraut <peter_e(at)gmx(dot)net>
Cc: <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [COMMITTERS] pgsql: Split contrib documentation into extensions and programs
Date: 2012-05-09 18:44:00
Message-ID: 1336588978-sup-2275@alvh.no-ip.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-committers pgsql-hackers


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(at)commandprompt(dot)com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support


From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
Cc: pgsql-hackers(at)postgresql(dot)org
Subject: Re: [COMMITTERS] pgsql: Split contrib documentation into extensions and programs
Date: 2012-07-17 18:53:36
Message-ID: 1342551216.26453.0.camel@vanquo.pezone.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-committers pgsql-hackers

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.