diff --git a/doc/src/sgml/func/func-math.sgml b/doc/src/sgml/func/func-math.sgml
index 9dcf97e7c9e..1e82a5b12b6 100644
--- a/doc/src/sgml/func/func-math.sgml
+++ b/doc/src/sgml/func/func-math.sgml
@@ -26,6 +26,13 @@
     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 terms of left shifting that results in
+    a signed overflow and in terms 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>