cvs: phpdoc /en language-snippets.ent

philip Thu Dec 6 15:13:02 2001 EDT Modified files: /phpdoc/en language-snippets.ent Log: Reword experimental function/module warnings a bit. Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.10 phpdoc/en/language-snippets.ent:1.11 --- phpdoc/en/language-snippets.ent:1.10 Fri Nov 16 12:57:06 2001 +++ phpdoc/en/language-snippets.ent Thu Dec 6 15:13:02 2001 @@ -1,13 +1,30 @@ -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> -<!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>'> +<!ENTITY warn.experimental '<warning><simpara>This module is +<emphasis>EXPERIMENTAL</emphasis>. The behaviour of these functions, +these function names, 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 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 warn.experimental.func '<warning><simpara>This function is +<emphasis>EXPERIMENTAL</emphasis>. The behaviour of this function, +this function name, 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>'> + +<!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>'> +<!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>'>