Re: [DOCS] Sync rep doc corrections

2011-03-09 Thread Bruce Momjian
Thom Brown wrote: > On 7 March 2011 22:31, Robert Haas wrote: > > On Mon, Mar 7, 2011 at 6:16 AM, Thom Brown wrote: > >> On 7 March 2011 15:27, Thom Brown wrote: > >>> I've attached a small patch with a bit of clarification and a typo fix > >>> in the synchronous_standby_names parameter info. >

[DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Leslie S Satenstein
On Wed, 3/9/11, Robert Haas wrote: From: Robert Haas Subject: Re: [DOCS] Improve initdb and pg_controldata manual pages To: "Bruce Momjian" Cc: "Tom Lane" , "PostgreSQL-documentation" Date: Wednesday, March 9, 2011, 12:21 PM On Wed, Mar 9, 2011 at 11:08 AM, Bruce Momjian wrote: >> Hard to

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Bruce Momjian
Robert Haas wrote: > On Wed, Mar 9, 2011 at 11:08 AM, Bruce Momjian wrote: > >> Hard to say. ?We have the problem that our docs were made by a lot of > >> people over a long period of time, so inconsistencies are a fact of > >> life. ?"Pro" documentation might be more consistent if it's written by

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Robert Haas
On Wed, Mar 9, 2011 at 11:08 AM, Bruce Momjian wrote: >> Hard to say.  We have the problem that our docs were made by a lot of >> people over a long period of time, so inconsistencies are a fact of >> life.  "Pro" documentation might be more consistent if it's written by a >> smaller group of peop

Re: [DOCS] use of '=' in long options documentation

2011-03-09 Thread Bruce Momjian
Kevin Grittner wrote: > Bruce Momjian wrote: > > Peter Eisentraut wrote: > >> On tis, 2011-03-08 at 22:32 -0500, Bruce Momjian wrote: > >>> Looking at our ref pages, I see some manual pages specify long > >>> options that take arguments using '=', e.g. initdb.sgml: > >>> > >>> --long-opt=opt >

Re: [DOCS] use of '=' in long options documentation

2011-03-09 Thread Kevin Grittner
Bruce Momjian wrote: > Peter Eisentraut wrote: >> On tis, 2011-03-08 at 22:32 -0500, Bruce Momjian wrote: >>> Looking at our ref pages, I see some manual pages specify long >>> options that take arguments using '=', e.g. initdb.sgml: >>> >>> --long-opt=opt >>> >>> and some do not, e.g. pg_du

Re: [DOCS] use of '=' in long options documentation

2011-03-09 Thread Bruce Momjian
Peter Eisentraut wrote: > On tis, 2011-03-08 at 22:32 -0500, Bruce Momjian wrote: > > Looking at our ref pages, I see some manual pages specify long options > > that take arguments using '=', e.g. initdb.sgml: > > > > --long-opt=opt > > > > and some do not, e.g. pg_dump.sgml: > > > > --l

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Bruce Momjian
Tom Lane wrote: > Bruce Momjian writes: > > Well, looking at the detailed option list, it looks fine: > > > -D directory > > --pgdata=directory > > > It is only at the top where we see the problem because -D/--pgdata is a > > required argument and there are necessary spaces because we ar

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Tom Lane
Bruce Momjian writes: > Well, looking at the detailed option list, it looks fine: > -D directory > --pgdata=directory > It is only at the top where we see the problem because -D/--pgdata is a > required argument and there are necesary spaces because we are showing > both -D and --pgd

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Bruce Momjian
Tom Lane wrote: > Bruce Momjian writes: > > Tom Lane wrote: > >> This seems like the most bizarre choice you could have made. > >> It now looks like the preferred spelling of initdb's switch, > >> for instance, is > >> > >> initdb --pgdata= /path/name > >> > >> ie, *both* an equal sign and a spa

Re: [DOCS] use of '=' in long options documentation

2011-03-09 Thread Peter Eisentraut
On tis, 2011-03-08 at 22:32 -0500, Bruce Momjian wrote: > Looking at our ref pages, I see some manual pages specify long options > that take arguments using '=', e.g. initdb.sgml: > > --long-opt=opt > > and some do not, e.g. pg_dump.sgml: > > --long-opt opt > > So, which should we u

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Tom Lane
Bruce Momjian writes: > Tom Lane wrote: >> This seems like the most bizarre choice you could have made. >> It now looks like the preferred spelling of initdb's switch, >> for instance, is >> >> initdb --pgdata= /path/name >> >> ie, *both* an equal sign and a space. Please rethink this. > Well,

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Bruce Momjian
Tom Lane wrote: > Bruce Momjian writes: > > I have applied the attached patch to improve the initdb and > > pg_controldata manual pages. Patch from gabrielle . > > This seems like the most bizarre choice you could have made. > It now looks like the preferred spelling of initdb's switch, > for in

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Tom Lane
Bruce Momjian writes: > I have applied the attached patch to improve the initdb and > pg_controldata manual pages. Patch from gabrielle . This seems like the most bizarre choice you could have made. It now looks like the preferred spelling of initdb's switch, for instance, is initdb --p

[DOCS] Improve initdb and pg_controldata manual pages

2011-03-09 Thread Bruce Momjian
I have applied the attached patch to improve the initdb and pg_controldata manual pages. Patch from gabrielle . -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + It's impossible for everything to be true. + diff --git a/doc/src/