- Better describe FILTER_VALIDATE_BOOLEAN's behavior (fixes bug #41305)

- Minor grammatical tweaks
- Tiny structural tweak


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@237908 c90b9560-bf6c-de11-be94-00142212c4b1

reference/filter/reference.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <!-- Purpose: basic.vartype -->
 <!-- Membership: pecl -->
 <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -11,16 +11,16 @@
   <section id="filter.intro">
    &reftitle.intro;
    <para>
-    This extension serves for validating and filtering data coming usually
-    from some insecure source such as user input.
+    This extension serves to validate and filter data coming from some insecure
+    source, such as user input.
    </para>
    <para>
-    The following filters currently exist, be sure to read the 
+    The following filters currently exist; be sure to read the 
     <link linkend="filter.constants">Filter Constants</link> section 
     for information that describes the behavior of each constant:
     <table>
      <title>Existing filters</title>
-     <tgroup cols="4">
+     <tgroup cols="5">
       <thead>
        <row>
         <entry>ID</entry>
@@ -48,11 +48,19 @@
         <entry><constant>FILTER_VALIDATE_BOOLEAN</constant></entry>
         <entry>"boolean"</entry>
         <entry></entry>
-        <entry></entry>
         <entry>
-         Returns &true; for "1", "true", "on" and "yes",
-         &false; for "0", "false", "off", "no", and "",
-         &null; otherwise.
+          <constant>FILTER_NULL_ON_FAILURE</constant>
+        </entry>
+        <entry>
+         <para>
+          Returns &true; for "1", "true", "on" and "yes".
+          Returns &false; otherwise.
+         </para>
+         <para>
+          If <constant>FILTER_NULL_ON_FAILURE</constant> is set, &false; is
+          returned only for "0", "false", "off", "no", and "", and
+          &null; is returned for all non-boolean values.
+         </para>
         </entry>
        </row>
        <row>