Re: [DOCS] explaining "context" column of pg_settings

2011-03-10 Thread Bruce Momjian
What did we ever do with this idea? --- Tom Lane wrote: > Josh Kupershmidt writes: > > The six different kinds of contexts in the pg_settings system view > > aren't terribly well documented. The current doc page says only:

[DOCS] System functions doc page tidy-up

2011-03-10 Thread Thom Brown
Attached is a minor patch which changes the following: Adds index entries for session_user and pg_describe_object Removes extraneous closing parenthesis from pg_describe_object Puts pg_describe_object and has_sequence_privilege in correct alphabetical position in function listing -- Thom Brown T

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] Sync rep doc corrections

2011-03-10 Thread Robert Haas
On Wed, Mar 9, 2011 at 11:43 PM, Bruce Momjian wrote: > 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

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

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

2011-03-10 Thread Bruce Momjian
Applied. --- Bruce Momjian wrote: > 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 ma