Re: libpq documentation cleanups (repost 3)

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: 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 17:46:40
Message-ID: 201101121746.p0CHkeI12307@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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.

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

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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Stephen Frost 2011-01-12 17:59:57 Re: Add support for logging the current role
Previous Message Stephen Frost 2011-01-12 17:37:15 Re: Add support for logging the current role