diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 8d8c39c55fc..1cf71f8903a 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -851,6 +851,13 @@ repeat('Pg', 4) <returnvalue>PgPgPgPg</returnvalue>
     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>