From b4fd230b170209328c108cf338225629e25b7e4a Mon Sep 17 00:00:00 2001
From: Adam Harvey <aharvey@php.net>
Date: Tue, 23 Nov 2010 11:07:51 +0000
Subject: [PATCH] Fixed doc bug #53371 (parse_url docs say it returns FALSE on
 malformed URLs. It may return NULL.) by reworking the return values section
 of the parse_url() manual page.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@305689 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/url/functions/parse-url.xml | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/reference/url/functions/parse-url.xml b/reference/url/functions/parse-url.xml
index 89beeaccef..3274c1bcb4 100644
--- a/reference/url/functions/parse-url.xml
+++ b/reference/url/functions/parse-url.xml
@@ -61,8 +61,12 @@
   &reftitle.returnvalues;
   <para>
    On seriously malformed URLs, <function>parse_url</function> may return
-   &false;. Otherwise an associative array is returned, whose components may
-   be (at least one):
+   &false;.
+  </para>
+  <para>
+   If the <parameter>component</parameter> parameter is omitted, an
+   associative <type>array</type> is returned. At least one element will be
+   present within the array. Potential keys within this array are:
    <itemizedlist>
     <listitem>
      <simpara>
@@ -107,8 +111,10 @@
    </itemizedlist>
   </para>
   <para>
-   If the <parameter>component</parameter> parameter is specified a
-   <type>string</type> is returned instead of an <type>array</type>.
+   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.
   </para>
  </refsect1>