Re: deprecating =>, take two

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Robert Haas <robertmhaas(at)gmail(dot)com>
Cc: pgsql-hackers(at)postgresql(dot)org
Subject: Re: deprecating =>, take two
Date: 2010-06-21 17:24:23
Message-ID: 14845.1277141063@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Robert Haas <robertmhaas(at)gmail(dot)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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Robert Haas 2010-06-21 17:33:32 Re: deprecating =>, take two
Previous Message mac_man2005@hotmail.it 2010-06-21 17:16:06 Re: About tapes