diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 1c42e39311a..8b9aab82d55 100644
--- 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 d5c385c087f..66c34e0072f 100644
--- 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
function must have been previously defined using CREATE