diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 6729dc677e8..7fb101f90f5 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -1,5 +1,5 @@
@@ -3870,6 +3870,11 @@ substring('foobar' from 'o(.)b') o
+
+ Warning. to_char(interval, text)
+ is deprecated and should not be used in newly-written code. Will be removed in the next version.
+
+
In an output template string (for to_char>), there are certain patterns that are
recognized and replaced with appropriately-formatted data from the value