cvs: phpdoc /en language-snippets.ent

goba Sun Nov 11 06:53:49 2001 EDT Modified files: /phpdoc/en language-snippets.ent Log: Adding language snippet requested by Jim Winstead about false and values evaluating to false Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.8 phpdoc/en/language-snippets.ent:1.9 --- phpdoc/en/language-snippets.ent:1.8 Sun Aug 19 07:55:42 2001 +++ phpdoc/en/language-snippets.ent Sun Nov 11 06:53:49 2001 @@ -1,4 +1,4 @@ -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'> <!ENTITY warn.experimental.func '<warning><simpara>This function is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this function at your own risk.</simpara></warning>'> @@ -6,6 +6,8 @@ <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> <!ENTITY return.success 'Returns &true; on succes, &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>'> <!-- Various notes --> <!ENTITY note.not-bin-safe '<warning><simpara>This function is not (yet) binary safe!</simpara></warning>'>