[PHP-DOC] cvs: phpdoc /en/functions funchand.xml

[jim winstead]

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>