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>'>
