summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref
diff options
context:
space:
mode:
authorRobert Haas <rhaas@postgresql.org>2010-06-22 11:36:16 +0000
committerRobert Haas <rhaas@postgresql.org>2010-06-22 11:36:16 +0000
commitf974212320960452950921d68c6fea275c2257da (patch)
treec596be9ea814d410a22bc028fb8985229c1c0dc6 /doc/src/sgml/ref
parent9b2c14cf115452fa595fa01c7943f4e532b8c86c (diff)
Deprecate the use of => as an operator name.
In HEAD, emit a warning when an operator named => is defined. In both HEAD and the backbranches (except in 8.2, where contrib modules do not have documentation), document that hstore's text => text operator may be removed in a future release, and encourage the use of the hstore(text, text) function instead. This function only exists in HEAD (previously, it was called tconvert), so backpatch it back to 8.2, when hstore was added. Per discussion.
Diffstat (limited to 'doc/src/sgml/ref')
-rw-r--r--doc/src/sgml/ref/create_operator.sgml8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/src/sgml/ref/create_operator.sgml b/doc/src/sgml/ref/create_operator.sgml
index a5595e6e69c..d70fefcf05c 100644
--- a/doc/src/sgml/ref/create_operator.sgml
+++ b/doc/src/sgml/ref/create_operator.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.52 2010/04/03 07:22:58 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_operator.sgml,v 1.53 2010/06/22 11:36:16 rhaas Exp $
PostgreSQL documentation
-->
@@ -71,6 +71,12 @@ CREATE OPERATOR <replaceable>name</replaceable> (
parse SQL-compliant commands without requiring spaces between tokens.
</para>
</listitem>
+ <listitem>
+ <para>
+ The use of <literal>=&gt;</> as an operator name is deprecated. It may
+ be disallowed altogether in a future release.
+ </para>
+ </listitem>
</itemizedlist>
</para>