cvs: phpdoc(REF_STRUCT_DEV) /en/reference/outcontrol reference.xml /en/reference/runkit constants.xml reference.xml

From: Date: Sat, 27 Oct 2007 21:23:43 +0000
Subject: cvs: phpdoc(REF_STRUCT_DEV) /en/reference/outcontrol reference.xml /en/reference/runkit constants.xml reference.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-301@lists.php.net to get a copy of this message
bjori Sat Oct 27 21:23:43 2007 UTC Modified files: (Branch: REF_STRUCT_DEV) /phpdoc/en/reference/outcontrol reference.xml /phpdoc/en/reference/runkit constants.xml reference.xml Log: Upgrade markup

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/outcontrol/reference.xml?r1=1.17.2.1&r2=1.17.2.2&diff_format=u Index: phpdoc/en/reference/outcontrol/reference.xml diff -u phpdoc/en/reference/outcontrol/reference.xml:1.17.2.1 phpdoc/en/reference/outcontrol/reference.xml:1.17.2.2 --- phpdoc/en/reference/outcontrol/reference.xml:1.17.2.1 Wed Oct 3 11:41:13 2007 +++ phpdoc/en/reference/outcontrol/reference.xml Sat Oct 27 21:23:43 2007 @@ -1,64 +1,71 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17.2.1 $ --> +<!-- $Revision: 1.17.2.2 $ --> <!-- Purpose: basic.php --> <!-- Membership: core --> - <reference xml:id="ref.outcontrol" xmlns="http://docbook.org/ns/docbook"> - <title>Output Control Functions</title> - <titleabbrev>Output Control</titleabbrev> +<book xml:id="ref.outcontrol" xmlns="http://docbook.org/ns/docbook"> + <title>Output Control Functions</title> + <titleabbrev>Output Control</titleabbrev> + + <preface xml:id="outcontrol.intro"> + &reftitle.intro; + <para> + The Output Control functions allow you to control when output is + sent from the script. This can be useful in several different + situations, especially if you need to send headers to the browser + after your script has began outputting data. The Output Control + functions do not affect headers sent using + <function>header</function> or <function>setcookie</function>, + only functions such as <function>echo</function> and data between + blocks of PHP code. + </para> + <note> + <para> + When upgrading from PHP 4.1.x (and 4.2.x) to 4.3.x due to a bug in + earlier versions you must ensure that + <literal>implict_flush</literal> is <literal>OFF</literal> in + your &php.ini;, otherwise any output with + <function>ob_start</function> will not be hidden from output. + </para> + </note> + </preface> + + <chapter xml:id="outcontrol.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Installing/Configuring</title> + + <section xml:id="outcontrol.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section xml:id="outcontrol.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.outcontrol.ini; + + <section xml:id="outcontrol.resources"> + &reftitle.resources; + &no.resource; + </section> + + </chapter> + + <appendix xml:id="outcontrol.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.constants; + &no.constants; + </appendix> + - <partintro> - <section xml:id="outcontrol.intro"> - &reftitle.intro; - <para> - The Output Control functions allow you to control when output is - sent from the script. This can be useful in several different - situations, especially if you need to send headers to the browser - after your script has began outputting data. The Output Control - functions do not affect headers sent using - <function>header</function> or <function>setcookie</function>, - only functions such as <function>echo</function> and data between - blocks of PHP code. - </para> - <note> - <para> - When upgrading from PHP 4.1.x (and 4.2.x) to 4.3.x due to a bug in - earlier versions you must ensure that - <literal>implict_flush</literal> is <literal>OFF</literal> in - your &php.ini;, otherwise any output with - <function>ob_start</function> will not be hidden from output. - </para> - </note> - </section> - - <section xml:id="outcontrol.requirements"> - &reftitle.required; - &no.requirement; - </section> - - <section xml:id="outcontrol.installation"> - &reftitle.install; - &no.install; - </section> - - &reference.outcontrol.ini; - - <section xml:id="outcontrol.resources"> - &reftitle.resources; - &no.resource; - </section> - - <section xml:id="outcontrol.constants"> - &reftitle.constants; - &no.constants; - </section> - - <section xml:id="outcontrol.examples"> + <appendix xml:id="outcontrol.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.examples; + <section xml:id="outcontrol.examples.basic"> &reftitle.examples; - <para> - <example> - <title>Output Control example</title> - <programlisting role="php"> + <para> + <example> + <title>Output Control example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -71,31 +78,34 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - In the above example, the output from <function>echo</function> - would be stored in the output buffer until - <function>ob_end_flush</function> was called. In the mean time, - the call to <function>setcookie</function> successfully stored a - cookie without causing an error. (You can not normally send - headers to the browser after data has already been sent.) - </para> - </section> - - <section xml:id="outcontrol.seealso"> - &reftitle.seealso; - <para> - See also <function>header</function> and - <function>setcookie</function>. - </para> - </section> + </programlisting> + </example> + </para> + <para> + In the above example, the output from <function>echo</function> + would be stored in the output buffer until + <function>ob_end_flush</function> was called. In the mean time, + the call to <function>setcookie</function> successfully stored a + cookie without causing an error. (You can not normally send + headers to the browser after data has already been sent.) + </para> + </section> + </appendix> + + <reference xml:id="functions.outcontrol" xmlns="http://docbook.org/ns/docbook"> + <partintro> + &reftitle.seealso; + <para> + See also <function>header</function> and + <function>setcookie</function>. + </para> </partintro> -&reference.outcontrol.functions.entities; + &reference.outcontrol.functions.entities; </reference> +</book> + <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/runkit/constants.xml?r1=1.6&r2=1.6.2.1&diff_format=u Index: phpdoc/en/reference/runkit/constants.xml diff -u phpdoc/en/reference/runkit/constants.xml:1.6 phpdoc/en/reference/runkit/constants.xml:1.6.2.1 --- phpdoc/en/reference/runkit/constants.xml:1.6 Wed Jun 20 22:25:18 2007 +++ phpdoc/en/reference/runkit/constants.xml Sat Oct 27 21:23:43 2007 @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.6.2.1 $ --> <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. --> -<section xml:id="runkit.constants" xmlns="http://docbook.org/ns/docbook"> +<appendix xml:id="runkit.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants; &extension.constants; <variablelist> @@ -191,7 +191,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/runkit/reference.xml?r1=1.11.2.1&r2=1.11.2.2&diff_format=u Index: phpdoc/en/reference/runkit/reference.xml diff -u phpdoc/en/reference/runkit/reference.xml:1.11.2.1 phpdoc/en/reference/runkit/reference.xml:1.11.2.2 --- phpdoc/en/reference/runkit/reference.xml:1.11.2.1 Wed Oct 3 11:41:14 2007 +++ phpdoc/en/reference/runkit/reference.xml Sat Oct 27 21:23:43 2007 @@ -1,33 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11.2.1 $ --> +<!-- $Revision: 1.11.2.2 $ --> <!-- Purpose: basic.php --> <!-- Membership: pecl --> -<reference xml:id="ref.runkit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> +<book xml:id="ref.runkit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>runkit Functions</title> <titleabbrev>runkit</titleabbrev> - <partintro> - <section xml:id="runkit.intro"> - &reftitle.intro; + <preface xml:id="runkit.intro"> + &reftitle.intro; + <simpara> + The runkit extension provides means to modify constants, + user-defined functions, and user-defined classes. + It also provides for custom superglobal variables + and embeddable sub-interpreters via sandboxing. + </simpara> + + <simpara> + This package is meant as a feature added replacement for the + <link xlink:href="&url.pecl.package;classkit">classkit</link> package. + When compiled with the <literal>--enable-runkit=classkit</literal> + option to ./configure, it will export classkit compatible function definitions + and constants. + </simpara> + </preface> + + <chapter xml:id="runkit.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>Installing/Configuring</title> + + <section xml:id="runkit.requirements"> + &reftitle.required; <simpara> - The runkit extension provides means to modify constants, - user-defined functions, and user-defined classes. - It also provides for custom superglobal variables - and embeddable sub-interpreters via sandboxing. + <emphasis>Modifying Constants, Functions, Classes, and Methods</emphasis> + works with all releases of PHP 4 and PHP 5. No special requirements are + necessary. </simpara> <simpara> - &pecl.info; - <link xlink:href="&url.pecl.package;runkit">&url.pecl.package;runkit</link>. + <emphasis>Custom Superglobals</emphasis> are only available in PHP 4.2.0 or later. </simpara> <simpara> - This package is meant as a feature added replacement for the - <link xlink:href="&url.pecl.package;classkit">classkit</link> package. - When compiled with the <literal>--enable-runkit=classkit</literal> - option to ./configure, it will export classkit compatible function definitions - and constants. + <emphasis>Sandboxing</emphasis> requires PHP 5.1.0 or later, or + PHP 5.0.0 with a special TSRM patch applied. + Regardless of which version of PHP is in use it must be compiled with the + <literal>--enable-maintainer-zts</literal> option. + See the <literal>README</literal> file in the runkit package for additional information. </simpara> </section> @@ -44,39 +62,27 @@ &pecl.windows.download; </para> </section> - - <section xml:id="runkit.requirements"> - &reftitle.required; - <simpara> - <emphasis>Modifying Constants, Functions, Classes, and Methods</emphasis> - works with all releases of PHP 4 and PHP 5. No special requirements are - necessary. - </simpara> - - <simpara> - <emphasis>Custom Superglobals</emphasis> are only available in PHP 4.2.0 or later. - </simpara> - - <simpara> - <emphasis>Sandboxing</emphasis> requires PHP 5.1.0 or later, or - PHP 5.0.0 with a special TSRM patch applied. - Regardless of which version of PHP is in use it must be compiled with the - <literal>--enable-maintainer-zts</literal> option. - See the <literal>README</literal> file in the runkit package for additional information. - </simpara> - </section> - + &reference.runkit.ini; - - &reference.runkit.constants; - - </partintro> - - &reference.runkit.sandbox; - &reference.runkit.sandbox-parent; - - &reference.runkit.functions.entities; -</reference> + + <section xml:id="runkit.resources"> + &reftitle.resources; + &no.resource; + </section> + + </chapter> + + &reference.runkit.constants; + + <reference xml:id="functions.runkit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>runkit &Functions;</title> + + &reference.runkit.sandbox; + &reference.runkit.sandbox-parent; + + &reference.runkit.functions.entities; + </reference> +</book> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc.cvs (#301) next »