diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index e5fa82c161..45553ab824 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -2783,6 +2783,13 @@ SELECT NOT(ROW(table.*) IS NOT NULL) FROM TABLE; -- detect at least one null in
specified. Provide at least one of start
and count.
+
+ Non-positive start values specify a
+ start position before the first character, and therefore the
+ count must be two greater than the absolute
+ value of start to begin returning characters
+ from the start of the string.
+
substring('Thomas' from 2 for 3)
hom
@@ -2794,6 +2801,10 @@ SELECT NOT(ROW(table.*) IS NOT NULL) FROM TABLE; -- detect at least one null in
substring('Thomas' for 2)
Th
+
+
+ substring('Thomas' from -4 for 8)
+ Tho