diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index bbbffd9d5b..6b183c5ad9 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1054,7 +1054,8 @@ repeat('Pg', 4) PgPgPgPg
numeric
- Factorial
+ Factorial (deprecated, will be removed in
+ PostgreSQL 14)
5 !
@@ -1068,7 +1069,8 @@ repeat('Pg', 4) PgPgPgPg
numeric
- Factorial (as a prefix operator)
+ Factorial (as a prefix operator; deprecated, will be removed in
+ PostgreSQL 14)
!! 5
diff --git a/doc/src/sgml/ref/create_operator.sgml b/doc/src/sgml/ref/create_operator.sgml
index d5c385c087..2d265f34ef 100644
--- a/doc/src/sgml/ref/create_operator.sgml
+++ b/doc/src/sgml/ref/create_operator.sgml
@@ -92,6 +92,13 @@ CREATE OPERATOR name (
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