[PHP-DOC] cvs: phpdoc /en language-snippets.ent

[Torben Wilson]

torben          Mon Feb 18 17:26:09 2002 EDT

  Modified files:              
    /phpdoc/en  language-snippets.ent 
  Log:
  Small fixups; minor clarification of &return.falseproblem;.
  
  
Index: phpdoc/en/language-snippets.ent
diff -u phpdoc/en/language-snippets.ent:1.19 phpdoc/en/language-snippets.ent:1.20
--- phpdoc/en/language-snippets.ent:1.19        Sat Dec 15 11:28:14 2001
+++ phpdoc/en/language-snippets.ent     Mon Feb 18 17:26:09 2002
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.19 $ -->
+<!-- $Revision: 1.20 $ -->
 
 <!ENTITY warn.experimental '<warning><simpara>This extension is
 <emphasis>EXPERIMENTAL</emphasis>. The behaviour of this extension,
@@ -14,7 +14,7 @@
 warned and use this function at your own risk.</simpara></warning>'>
 
 <!ENTITY warn.undocumented.func '<warning><simpara>This function is
-currently not documented, only the argument list is
+currently not documented; only the argument list is
 available.</simpara></warning>'>
 
 <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs
@@ -30,10 +30,13 @@
 <!ENTITY return.success 'Returns &true; on success, &false; on failure.'>
 
 <!ENTITY return.falseproblem '<warning><simpara>This function may
-return &false;, but may also return a value evaluating to &false; in a
-simple if statement. Please use <link
-linkend="language.operators.comparison">the === operator</link> for
-testing the return value of this function.</simpara></warning>'>    
+return Boolean &false;, but may also return a non-Boolean value which
+evaluates to &false;, such as <literal>0</literal> or
+&quot;&quot;. Please read the section on <link
+linkend="language.types.boolean">Booleans</link> for more
+information. Use <link linkend="language.operators.comparison">the ===
+operator</link> for testing the return value of this
+function.</simpara></warning>'>
 
 <!-- Various notes -->
 <!ENTITY note.not-bin-safe '<warning><simpara>This function