diff --git a/functions/mysql.xml b/functions/mysql.xml
index 3b502a2a63..14ed6aa18c 100644
--- a/functions/mysql.xml
+++ b/functions/mysql.xml
@@ -164,8 +164,8 @@
      </paramdef>
     </funcsynopsis>
     <para> 
-     Returns: A positive MySQL link identifier on success, or false on
-     error.
+     Returns: A positive MySQL link identifier on success, or an error
+     message on failure.
     </para>
     <para> 
      <function>mysql_connect</function> establishes a connection to a
@@ -185,9 +185,13 @@
        Support for the &quot;:/path/to/socket&quot; was added in
        PHP 3.0.10.
       </para>
+      <para>
+      You can suppress the error message on failure by prepending '@'
+      to the function name.
+      </para>
      </note>
     </para>
-    <para> 
+    <para>
      In case a second call is made to
      <function>mysql_connect</function> with the same arguments, no
      new link will be established, but instead, the link identifier of