Skip site navigation (1) Skip section navigation (2)

Re: libpq documentation cleanups (repost 3)

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Robert Haas <robertmhaas(at)gmail(dot)com>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, Leslie S Satenstein <lsatenstein(at)yahoo(dot)com>
Subject: Re: libpq documentation cleanups (repost 3)
Date: 2011-01-12 18:12:48
Message-ID: 201101121812.p0CICm021975@momjian.us (view raw or flat)
Thread:
Lists: pgsql-hackers
Bruce Momjian wrote:
> Robert Haas wrote:
> > On Wed, Jan 12, 2011 at 11:53 AM, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
> > > The attached patch is a collection of libpq documentation cleanups
> > > recommended in a list of changes emailed to me by Leslie S Satenstein.
> > >
> > > Leslie found a number of places our libpq documentation that were unclear
> > > or awkward, and this diff generated by me attempts to address them.
> > >
> > > I have already updated the documentation proofreading wiki:
> > >
> > > ? ? ? ?http://wiki.postgresql.org/wiki/Documentation_Proofreading
> > 
> > I don't think changing "see below" to "refer below" or "call" to
> > "execute" is an improvement; even if we did that uniformly throughout
> > our documentation, surely future editors are going to reuse those
> > phrasings.
> > 
> > A lot of these other changes look pretty dubious too, although some
> > seem worthwhile.
> 
> OK, that last part seems kind of vague.  ;-)  Can you hack up the diff
> to have just the changes you think are worthwhile?  You can just remove
> the parts of the diff you don't like.

Robert, here is a unified diff, which I think it easier to review for
single-line documention changes.

-- 
  Bruce Momjian  <bruce(at)momjian(dot)us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +

Attachment: /pgpatches/libpq.gz
Description: application/x-gzip (5.9 KB)

In response to

Responses

pgsql-hackers by date

Next:From: Josh BerkusDate: 2011-01-12 18:27:00
Subject: Re: Compatibility GUC for serializable
Previous:From: Tom LaneDate: 2011-01-12 18:06:59
Subject: Re: pg_depend explained

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group