cvs: phpdoc /en/functions funchand.xml

jimw Tue Dec 18 14:55:27 2001 EDT Modified files: /phpdoc/en/functions funchand.xml Log: register_shutdown_function: incorporate user notes Index: phpdoc/en/functions/funchand.xml diff -u phpdoc/en/functions/funchand.xml:1.23 phpdoc/en/functions/funchand.xml:1.24 --- phpdoc/en/functions/funchand.xml:1.23 Wed Dec 12 15:46:49 2001 +++ phpdoc/en/functions/funchand.xml Tue Dec 18 14:55:26 2001 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.23 $ --> +<!-- $Revision: 1.24 $ --> <reference id="ref.funchand"> <title>Function Handling functions</title> <titleabbrev>Functions</titleabbrev> @@ -575,15 +575,23 @@ </funcsynopsis> <simpara> Registers the function named by <parameter>func</parameter> to be - executed when script processing is complete.</simpara> + executed when script processing is complete. + </simpara> <para> - Common Pitfalls: + Multiple calls to <function>register_shutdown_function</function> can be + made, and each will be called in the same order as they were registered. + If you call <function>exit</function> within one registered shutdown + function, processing will stop completely and no other registered + shutdown functions will be called. </para> - <simpara> - Since no output is allowed to the browser in this function, you - will be unable to debug it using statements such as print or - echo. - </simpara> + <para> + The registered shutdown functions are called after the request has been + completed (including sending any output buffers), so it is not possible + to send output to the browser using <function>echo</function> or + <function>print</function>, or retrieve the contents of any output + buffers using <function>ob_get_contents</function>. + </para> + &note.func-callback; </refsect1> </refentry>