jimw		Tue Dec 18 17:43:32 2001 EDT

  Modified files:              
    /phpdoc/en/functions	session.xml 
  Log:
  session_register: incorporate notes
  
Index: phpdoc/en/functions/session.xml
diff -u phpdoc/en/functions/session.xml:1.68 phpdoc/en/functions/session.xml:1.69
--- phpdoc/en/functions/session.xml:1.68	Tue Dec 18 17:22:54 2001
+++ phpdoc/en/functions/session.xml	Tue Dec 18 17:43:31 2001
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?> 
-<!-- $Revision: 1.68 $ --> 
+<!-- $Revision: 1.69 $ --> 
  <reference id="ref.session"> 
   <title> Session handling functions</title>
   <titleabbrev> Sessions</titleabbrev>
@@ -570,17 +570,46 @@
      </funcprototype> 
     </funcsynopsis> 
     <para> 
-     <function> session_register</function> variable number of
-     arguments, any of which can be either a string holding the
-     variable name or an array consisting of such variable names or
-     other arrays. For each encountered variable name,
-     <function> session_register</function> registers the global
-     variable named by it with the current session.
+     <function> session_register</function> accepts a variable number of
+     arguments, any of which can be either a string holding the name of a
+     variable or an array consisting of variable names or other arrays. For
+     each name, <function> session_register</function> registers the global
+     variable with that name in the current session.
     </para> 
+    <caution> 
+     <para> 
+      This registers a <emphasis> global</emphasis> variable. If you want to
+      register a session variable inside a function, you need to make sure to
+      make it global using <function> global</function> or use the session
+      arrays as noted below.
+     </para> 
+    </caution> 
     <para> 
-     This function returns &true; when the variable is successfully
+     This function returns &true; when all of the variables are successfully
      registered with the session.
     </para> 
+    <para> 
+     If <function> session_start</function> was not called before this function
+     is called, an implicit call to <function> session_start</function> with no
+     parameters will be made.
+    </para> 
+    <para> 
+     You can also create a session variable by simply setting the appropriate
+     member of the $HTTP_SESSION_VARS or $_SESSION (PHP > = 4.1.0) array.
+     <informalexample> 
+      <programlisting role="php"> 
+<![CDATA[
+$barney = "A big purple dinosaur.";
+session_register("barney");
+
+$HTTP_SESSION_VARS["zim"] = "An invader from another planet.";
+
+# the auto-global $_SESSION array was introduced in PHP 4.1.0
+$_SESSION["spongebob"] = "He's got square pants.";
+]]> 
+      </programlisting> 
+     </informalexample> 
+    </para> 
     <note> 
      <para> 
       It is not currently possible to register resource variables in a
@@ -594,6 +623,10 @@
       <link linkend="resource"> resource types</link> appendix.
      </para> 
     </note> 
+    <para> 
+     See also <function> session_is_registered</function> and
+     <function> session_unregister</function>.
+    </para> 
    </refsect1> 
   </refentry>