Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-10 Thread Robert Haas
On Wed, Mar 9, 2011 at 8:43 PM, Leslie S Satenstein wrote: > The docs need consistency, so that the information therein is not > misconstrued by an English speaking / reading non-American.  The > documentation has many many grammar mistakes, where pronouns refer back to > more than one noun, or

Re: [DOCS] Improve initdb and pg_controldata manual pages

2011-03-10 Thread Alvaro Herrera
Excerpts from Leslie S Satenstein's message of mié mar 09 22:43:19 -0300 2011: > I have to agree with Bruce M. that the docs are in need of some work. > I think there are two or more viewpoints. I don't think you're going to find anyone to state that the docs are perfect. Most people will say th

[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, Br

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] 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] 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/