Re: deprecating =>, take two

Tom Lane <tgl@sss.pgh.pa.us>

From: Tom Lane <tgl@sss.pgh.pa.us>
To: Robert Haas <robertmhaas@gmail.com>
Cc: pgsql-hackers@postgresql.org
Date: 2010-06-21T17:24:23Z
Lists: pgsql-hackers
Robert Haas <robertmhaas@gmail.com> writes:
> Barring vigorous objections, I will apply these tomorrow so that we
> can consider deprecating => as an operator name in 9.1, for better
> compliance with the SQL standard.

Two documentation comments:

1. Perhaps, rather than

> +   The <literal>=&gt;</> operator is deprecated and may be removed in a
> +   future release.  The use of the <literal>hstore(text, text)</literal>
> +   function is recommended as an alternative.

write

> +   The <literal>=&gt;</> operator is deprecated and will be removed in a
> +   future release.  Use the <literal>hstore(text, text)</literal>
> +   function instead.

in particular, s/may/will/ and avoid passive voice in the second sentence.

2. The 8.4 and 8.3 doc patches should include this same paragraph.

			regards, tom lane