gwynne Sun Jun 17 11:55:54 2007 UTC
Modified files:
/phpdoc/en/reference/filter reference.xml
Log:
- Better describe FILTER_VALIDATE_BOOLEAN's behavior (fixes bug #41305)
- Minor grammatical tweaks
- Tiny structural tweak
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/filter/reference.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc/en/reference/filter/reference.xml
diff -u phpdoc/en/reference/filter/reference.xml:1.9
phpdoc/en/reference/filter/reference.xml:1.10
--- phpdoc/en/reference/filter/reference.xml:1.9 Thu Jun 14 08:03:47 2007
+++ phpdoc/en/reference/filter/reference.xml Sun Jun 17 11:55:54 2007
@@ -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>
