diff --git a/reference/url/functions/parse-url.xml b/reference/url/functions/parse-url.xml
index 3274c1bcb4..bb7d5c2807 100644
--- a/reference/url/functions/parse-url.xml
+++ b/reference/url/functions/parse-url.xml
@@ -49,7 +49,9 @@
        <constant>PHP_URL_USER</constant>, <constant>PHP_URL_PASS</constant>,
        <constant>PHP_URL_PATH</constant>, <constant>PHP_URL_QUERY</constant>
        or <constant>PHP_URL_FRAGMENT</constant> to retrieve just a specific
-       URL component as a <type>string</type>.
+       URL component as a <type>string</type> (except when
+       <constant>PHP_URL_PORT</constant> is given, in which case the return
+       value will be an <type>integer</type>).
       </para>
      </listitem>
     </varlistentry>
@@ -112,9 +114,10 @@
   </para>
   <para>
    If the <parameter>component</parameter> parameter is specified,
-   <function>parse_url</function> returns a <type>string</type> instead of an
-   <type>array</type>. If the requested component doesn't exist within the
-   given URL, &null; will be returned.
+   <function>parse_url</function> returns a <type>string</type> (or an
+   <type>integer</type>, in the case of <constant>PHP_URL_PORT</constant>)
+   instead of an <type>array</type>. If the requested component doesn't exist
+   within the given URL, &null; will be returned.
   </para>
  </refsect1>