diff --git a/reference/mysql/functions/mysql-connect.xml b/reference/mysql/functions/mysql-connect.xml
index c9bb0e5b37..aa1d499d63 100644
--- a/reference/mysql/functions/mysql-connect.xml
+++ b/reference/mysql/functions/mysql-connect.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
   <refentry id="function.mysql-connect">
    <refnamediv>
@@ -39,9 +39,19 @@
     </para>
     <para>
      The <parameter>server</parameter> parameter can also include a port
-     number. eg. &quot;hostname:port&quot; or a path to a socket
+     number. eg. &quot;hostname:port&quot; or a path to a local socket
      eg. &quot;:/path/to/socket&quot; for the localhost.
      <note>
+      <para>
+       Whenever you specify &quot;localhost&quot; or
+       &quot;localhost:port&quot; as server, the MySQL client library will
+       override this and try to connect to a local socket (named pipe on
+       Windows). If you want to use TCP/IP, use &quot;127.0.0.1&quot;
+       instead of &quot;localhost&quot;. If the MySQL client library tries to
+       connect to the wrong local socket, you should set the correct path as
+       mysql.default_host in your PHP configuration and leave the server field
+       blank.
+      </para>
       <para>
        Support for &quot;:port&quot; was added in PHP 3.0B4.
       </para>