diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index bee23b7157d..1eb9f48cb25 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -863,6 +863,13 @@ SELECT NOT(ROW(table.*) IS NOT NULL) FROM TABLE; -- detect at least one null in
     are resolved by using the type appearing later in these lists.
    </para>
 
+   <para>
+    The behavior of bitwise shifting, both left and right, has
+    platform-dependent behavior both in cases of left shifting that results in
+    a signed overflow and in cases of the results of shifting by more bits
+    than exist in the type or from shifting by a negative value.
+   </para>
+
    <table id="functions-math-op-table">
     <title>Mathematical Operators</title>