Re: deprecating =>, take two - Mailing list pgsql-hackers

From Tom Lane
Subject Re: deprecating =>, take two
Date
Msg-id 14845.1277141063@sss.pgh.pa.us
Whole thread Raw
In response to deprecating =>, take two  (Robert Haas <robertmhaas@gmail.com>)
Responses Re: deprecating =>, take two
List 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>=></> 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>=></> 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


pgsql-hackers by date:

Previous
From: Simon Riggs
Date:
Subject: Re: extensible enum types
Next
From: Robert Haas
Date:
Subject: Re: deprecating =>, take two