diff --git a/reference/mysql/functions/mysql-real-escape-string.xml b/reference/mysql/functions/mysql-real-escape-string.xml
index 4348c0a648..4db3623b71 100644
--- a/reference/mysql/functions/mysql-real-escape-string.xml
+++ b/reference/mysql/functions/mysql-real-escape-string.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.20 $ -->
+<!-- $Revision: 1.21 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.100 -->
   <refentry id="function.mysql-real-escape-string">
    <refnamediv>
@@ -35,6 +35,15 @@
      <function>mysql_query</function>. If binary data is to be inserted, this function
      must be used.
     </para>
+    <note>
+     <para>
+      A MySQL connection is required before using 
+      <function>mysql_real_escape_string</function> otherwise an error of
+      level <literal>E_WARNING</literal> is generated, and &false; is 
+      returned. If <parameter>link_identifier</parameter> isn't defined, the
+      last MySQL connection is used.
+     </para>
+    </note>
     <para>
      <function>mysql_real_escape_string</function> calls MySQL's library function
      mysql_escape_string, which prepends backslashes to the following characters: