diff --git a/reference/pdo_mysql/reference.xml b/reference/pdo_mysql/reference.xml
index 3d572eb625..c0ec8c41f6 100644
--- a/reference/pdo_mysql/reference.xml
+++ b/reference/pdo_mysql/reference.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <!-- Purpose: database.vendors -->
 <!-- Membership: bundled, external, pecl -->
 
@@ -60,6 +60,14 @@
         </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><constant>port</constant></term>
+       <listitem>
+        <para>
+         The port number where the database server is listening.
+        </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><constant>dbname</constant></term>
        <listitem>
@@ -68,6 +76,15 @@
         </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><constant>unix_socket</constant></term>
+       <listitem>
+        <para>
+         The MySQL unix socket (shouldn't be used with <literal>host</literal>
+         or <literal>port</literal>).
+        </para>
+       </listitem>
+      </varlistentry>
      </variablelist>
     </para>
    </refsect1>
@@ -79,8 +96,16 @@
       <para>
        The following example shows a PDO_MYSQL DSN for connecting to
        MySQL databases:
-       <programlisting><![CDATA[
+       <programlisting>
+<![CDATA[
 mysql:host=localhost;dbname=testdb
+]]>
+       </programlisting>
+       More complete examples:
+       <programlisting>
+<![CDATA[
+mysql:host=localhost;port=3307;dbname=testdb
+mysql:unix_socket=/tmp/mysql.sock;dbname=testdb
 ]]>
        </programlisting>
       </para>