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
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
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
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
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
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
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
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
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,
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
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
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/
12 matches
Mail list logo