Re: deprecating =>, take two

On Mon, Jun 21, 2010 at 1:24 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> 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.

Avoiding the passive voice is a good idea, and I like your suggested
phrasing.  I'm reluctant to say what we "will" do in a future release
because we don't always do what we claim we'll do.  For example, we're
planning to remove contrib/xml2 in 8.4.

http://developer.postgresql.org/pgdocs/postgres/xml2.html

Still, I haven't heard too many arguments against disallowing => as an
operator, so perhaps it's safe to bank on it actually happening in
this case?

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

OK.

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