diff --git a/language/operators.xml b/language/operators.xml
index 3ab90bd394..a62bac5f2a 100644
--- a/language/operators.xml
+++ b/language/operators.xml
@@ -1224,6 +1224,19 @@ function standard_array_compare($op1, $op2)
     <link linkend="language.types">Types</link>.
    </para>
 
+   <warning>
+    <title>Comparison of floating point numbers</title>
+
+    <para>
+     Because of the way <type>float</type>s are represented internally, you
+     should not test two <type>float</type>s for equality.
+    </para>
+
+    <para>
+     See the documentation for <type>float</type> for more information.
+    </para>
+   </warning>
+
    <sect2 xml:id="language.operators.comparison.ternary">
     <title>Ternary Operator</title>
     <para>