rdelaage/postgresql
1
0
Fork 0
mirror of https://git.postgresql.org/git/postgresql.git synced 2024-10-02 03:11:17 +02:00
Code Issues Packages Projects Releases Wiki Activity

Mark factorial operator, and postfix operators in general, as deprecated.

Browse Source 
Back-patch key parts of 4c5cf5431 and 6ca547cf7 into stable branches.
I didn't touch pg_description entries here, so it's purely a docs
change; and I didn't fool with any examples either.  The main point
is so that anyone who's wondering if factorial() exists in the stable
branches will be reassured.

Mark Dilger and John Naylor, with some adjustments by me

Discussion: https://postgr.es/m/BE2DF53D-251A-4E26-972F-930E523580E9@enterprisedb.com
This commit is contained in:
Tom Lane 2020-08-30 16:03:19 -04:00
parent ff3c16d1e7
commit 9dee85b5b8
2 changed files with 25 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/src/sgml/func.sgml
View File

@ -666,14 +666,16 @@
<row>
<entry> <literal>!</literal> </entry>
<entry>factorial</entry>
<entry>factorial
(deprecated, use <function>factorial()</function> instead)</entry>
<entry><literal>5 !</literal></entry>
<entry><literal>120</literal></entry>
</row>
<row>
<entry> <literal>!!</literal> </entry>
<entry>factorial (prefix operator)</entry>
<entry>factorial as a prefix operator
(deprecated, use <function>factorial()</function> instead)</entry>
<entry><literal>!! 5</literal></entry>
<entry><literal>120</literal></entry>
</row>
@ -856,6 +858,19 @@
<entry><literal>2.71828182845905</literal></entry>
</row>
<row>
<entry>
<indexterm>
<primary>factorial</primary>
</indexterm>
<literal><function>factorial(<type>bigint</type>)</function></literal>
</entry>
<entry><type>numeric</type></entry>
<entry>factorial</entry>
<entry><literal>factorial(5)</literal></entry>
<entry><literal>120</literal></entry>
</row>
<row>
<entry>
<indexterm>

9
doc/src/sgml/ref/create_operator.sgml
View File

@ -87,11 +87,18 @@ CREATE OPERATOR <replaceable>name</replaceable> (
<para>
At least one of <literal>LEFTARG</literal> and <literal>RIGHTARG</literal> must be defined. For
binary operators, both must be defined. For right unary
binary operators, both must be defined. For right unary
operators, only <literal>LEFTARG</literal> should be defined, while for left
unary operators only <literal>RIGHTARG</literal> should be defined.
</para>
<note>
<para>
Right unary, also called postfix, operators are deprecated and will be
removed in <productname>PostgreSQL</productname> version 14.
</para>
</note>
<para>
The <replaceable class="parameter">function_name</replaceable>
function must have been previously defined using <command>CREATE