From: "Kevin Grittner" on
Robert Haas <robertmhaas(a)gmail.com> wrote:

> Here's an attempt at rewording the sections so that the
> information is included in each parameter's description without
> taking up a whole sentence.
>
> Thoughts?

It makes the point without beating one over the head with it. I
particularly like the way this patch moves the main point of the
parameter to the front, with all the conditions under which it might
be ignored pushed farther back. It reads much better that way, at
least for me.

-Kevin

--
Sent via pgsql-hackers mailing list (pgsql-hackers(a)postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

From: Tom Lane on
"Kevin Grittner" <Kevin.Grittner(a)wicourts.gov> writes:
> Robert Haas <robertmhaas(a)gmail.com> wrote:
>> Here's an attempt at rewording the sections so that the
>> information is included in each parameter's description without
>> taking up a whole sentence.
>>
>> Thoughts?

> It makes the point without beating one over the head with it. I
> particularly like the way this patch moves the main point of the
> parameter to the front, with all the conditions under which it might
> be ignored pushed farther back. It reads much better that way, at
> least for me.

Looks good to me too.

regards, tom lane

--
Sent via pgsql-hackers mailing list (pgsql-hackers(a)postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers

From: Robert Haas on
On Fri, Jun 25, 2010 at 1:02 PM, Tom Lane <tgl(a)sss.pgh.pa.us> wrote:
> "Kevin Grittner" <Kevin.Grittner(a)wicourts.gov> writes:
>> Robert Haas <robertmhaas(a)gmail.com> wrote:
>>> Here's an attempt at rewording the sections so that the
>>> information is included in each parameter's description without
>>> taking up a whole sentence.
>>>
>>> Thoughts?
>
>> It makes the point without beating one over the head with it. �I
>> particularly like the way this patch moves the main point of the
>> parameter to the front, with all the conditions under which it might
>> be ignored pushed farther back. �It reads much better that way, at
>> least for me.
>
> Looks good to me too.

OK, committed.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise Postgres Company

--
Sent via pgsql-hackers mailing list (pgsql-hackers(a)postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-hackers