[ZF-11900] DOCUMENTATION

Update Zend_Validate_Hostname documentation to match actual implementation


git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@24570 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/en/module_specs/Zend_Validate-Hostname.xml

@@ -94,18 +94,21 @@ if ($validator->isValid($hostname)) {
             The <classname>Zend_Validate_Hostname</classname> constants are:
             <constant>ALLOW_DNS</constant> to allow only
             <acronym>DNS</acronym> hostnames, <constant>ALLOW_IP</constant> to allow IP addresses,
-            <constant>ALLOW_LOCAL</constant> to allow local network names, and
-            <constant>ALLOW_ALL</constant> to allow all three above types.
+            <constant>ALLOW_LOCAL</constant> to allow local network names,
+            <constant>ALLOW_URI</constant> to allow
+            <ulink url="http://tools.ietf.org/html/rfc3986">RFC3986</ulink>-compliant addresses,
+            and <constant>ALLOW_ALL</constant> to allow all four above types.
         </para>
 
-        <para>
-            Additionally there is <constant>ALLOW_URI</constant> which allows to check hostnames
-            according to <ulink url="http://tools.ietf.org/html/rfc3986">RFC3986</ulink>. These
-            are registered names which are used by <acronym>WINS</acronym>, NetInfo and also local
-            hostnames like those defined within your <filename>.hosts</filename> file. For security
-            reasons <constant>ALLOW_URI</constant> is not contained within
-            <constant>ALLOW_ALL</constant>.
-        </para>
+        <note>
+            <title>Additional Information on ALLOW_URI</title>
+            <para>
+                <constant>ALLOW_URI</constant> allows to check hostnames
+                according to <ulink url="http://tools.ietf.org/html/rfc3986">RFC3986</ulink>. These
+                are registered names which are used by <acronym>WINS</acronym>, NetInfo and also local
+                hostnames like those defined within your <filename>.hosts</filename> file.
+            </para>
+        </note>
 
         <para>
             To just check for IP addresses you can use the example below: