From: | Robert Haas <robertmhaas(at)gmail(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us> |
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:04:40 |
Message-ID: | AANLkTi=KS+8ojW7RSTvrmRMeMzoREcxrspyXtaiKCnzZ@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
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.
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
From | Date | Subject | |
---|---|---|---|
Next Message | Stephen Frost | 2011-01-12 17:13:47 | Re: Add support for logging the current role |
Previous Message | Robert Haas | 2011-01-12 16:59:11 | Re: Add support for logging the current role |