diff --git a/functions/session.xml b/functions/session.xml
index 1ba52f636d..ec081e52b7 100644
--- a/functions/session.xml
+++ b/functions/session.xml
@@ -35,15 +35,49 @@
     by the session module unless the user defines them later.
    </para>
    <para>
-    <literal>track_vars</literal> and <literal>gpc_globals</literal>
-    configuration settings influence how the session variables get
-    restored. If <literal>track_vars</literal> is enabled, then the
-    restored session variables will be available in the global
-    associative array $HTTP_STATE_VARS. If
-    <literal>gpc_globals</literal> is enabled, then the session
-    variables will be restored to corresponding global variables. If
-    both of these settings are enabled, then the globals variables and
-    the $HTTP_STATE_VARS entries will reference the same value.
+    <literal>track_vars</literal> and <literal>register_globals</literal>
+    configuration settings influence how the session variables get stored
+    and restored.
+   </para> 
+   <para>
+    If <literal>track_vars</literal> is enabled and 
+    <literal>register_globals</literal> is disabled, only members of the
+    global associative array $HTTP_SESSION_VARS can be registered as 
+    session variables. The restored session variables will only be 
+    available in the array $HTTP_SESSION_VARS.
+  <example>
+     <title>
+      Registering a variable with <literal>track_vars</literal> enabled
+     </title>
+     <programlisting role="php">
+&lt;?php
+session_register("count");
+$HTTP_SESSION_VARS["count"]++;
+?&gt;
+     </programlisting>
+    </example>
+   </para>
+   <para>
+    If <literal>register_globals</literal> is enabled, then all global
+    variables can be registered as session variables and the session
+    variables will be restored to corresponding global variables. 
+  <example>
+     <title>
+      Registering a variable with <literal>register_globals</literal> enabled
+     </title>
+     <programlisting role="php">
+&lt;?php
+session_register("count");
+$count++;
+?&gt;
+     </programlisting>
+    </example>
+   </para>
+   <para>
+    If both <literal>track_vars</literal> and 
+    <literal>register_globals</literal> are enabled, then the globals 
+    variables and the $HTTP_SESSION_VARS entries will reference the same 
+    value.
    </para>
    <para>
     There are two methods to propagate a session id: