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

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

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 4617e081ee795a52713d0c36ba03ee78badd0b79..670ed7955128d1fd5ad07e19c2541d4926dec6d2 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -666,14 +666,16 @@
 
       
         ! 
-       factorial
+       factorial
+        (deprecated, use factorial() instead)
        5 !
        120
       
 
       
         !! 
-       factorial (prefix operator)
+       factorial as a prefix operator
+        (deprecated, use factorial() instead)
        !! 5
        120
       
@@ -856,6 +858,19 @@
        2.71828182845905
       
 
+      
+       
+        
+         factorial
+        
+        factorial(bigint)
+       
+       numeric
+       factorial
+       factorial(5)
+       120
+      
+
       
        
         

diff --git a/doc/src/sgml/ref/create_operator.sgml b/doc/src/sgml/ref/create_operator.sgml
index 818e3a2315a569227933d48bde8358042d10b5cf..73ccac7fecf6f8245423b23227073aadbff5dee3 100644 (file)
--- a/doc/src/sgml/ref/create_operator.sgml
+++ b/doc/src/sgml/ref/create_operator.sgml
@@ -87,11 +87,18 @@ CREATE OPERATOR name (
 
   
    At least one of LEFTARG and RIGHTARG must be defined.  For
-   binary operators, both must be defined. For right  unary
+   binary operators, both must be defined. For right unary
    operators, only LEFTARG should be defined, while for left
    unary operators only RIGHTARG should be defined.
   
 
+  
+   
+    Right unary, also called postfix, operators are deprecated and will be
+    removed in PostgreSQL version 14.
+   
+  
+
   
    The function_name
    procedure must have been previously defined using CREATE