Re: libpq documentation cleanups (repost 3) - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: libpq documentation cleanups (repost 3)
Date
Msg-id 1294866312.6322.0.camel@vanquo.pezone.net
Whole thread Raw
In response to Re: libpq documentation cleanups (repost 3)  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-hackers
On ons, 2011-01-12 at 12:04 -0500, Robert Haas wrote:
> On Wed, Jan 12, 2011 at 11:53 AM, Bruce Momjian <bruce@momjian.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.

Agreed.

> A lot of these other changes look pretty dubious too, although some
> seem worthwhile.

Agreed. :-/




pgsql-hackers by date:

Previous
From: Dimitri Fontaine
Date:
Subject: Re: Add function dependencies
Next
From: Tom Lane
Date:
Subject: Re: arrays as pl/perl input arguments [PATCH]