diff --git a/reference/mysqli/mysqli/real-escape-string.xml b/reference/mysqli/mysqli/real-escape-string.xml
index f6324afa47..44abfaf678 100644
--- a/reference/mysqli/mysqli/real-escape-string.xml
+++ b/reference/mysqli/mysqli/real-escape-string.xml
@@ -137,6 +137,20 @@ Error: 42000
   </example>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    For those accustomed to using <function>mysql_real_escape_string</function>,
+    note that the arguments of <function>mysqli_real_escape_string</function>
+    differ from what <function>mysql_real_escape_string</function> expects.
+    The <parameter>link</parameter> identifier comes first in 
+    <function>mysqli_real_escape_string</function>, whereas the string to be escaped
+    comes first in <function>mysql_real_escape_string</function>.
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>