diff --git a/reference/session/functions/session-register.xml b/reference/session/functions/session-register.xml
index df30a3d7c8..c3c6ccf2e7 100644
--- a/reference/session/functions/session-register.xml
+++ b/reference/session/functions/session-register.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 -->
   <refentry id="function.session-register">
    <refnamediv>
@@ -25,16 +25,20 @@
     <caution>
      <para>
       If you want your script to work regardless of <link
-      linkend="ini.register-globals"><literal>register_globals</literal></link>,
-      you need to use the <varname>$_SESSION</varname> array. All
-      <varname>$_SESSION</varname>  entries are automatically
+      linkend="ini.register-globals">register_globals</link>,
+      you need to instead use the 
+      <link linkend="reserved.variables.session">$_SESSION</link> array 
+      as <varname>$_SESSION</varname> entries are automatically
       registered. If your script uses
       <function>session_register</function>, it will not work in
-      environments where <link
-      linkend="ini.register-globals"><literal>register_globals</literal></link>
+      environments where the PHP directive 
+      <link linkend="ini.register-globals">register_globals</link>
       is disabled.
      </para>
     </caution>
+    
+    &note.registerglobals;
+    
     <caution>
      <para>
       This registers a <emphasis>global</emphasis> variable. If you
@@ -71,13 +75,17 @@
      <informalexample>
       <programlisting role="php">
 <![CDATA[
+<?php
+// Use of session_register() is deprecated
 $barney = "A big purple dinosaur.";
 session_register("barney");
 
+// Use of $_SESSION is preferred, as of PHP 4.1.0
 $_SESSION["zim"] = "An invader from another planet.";
 
-# The old way was to use $HTTP_SESSION_VARS
+// The old way was to use $HTTP_SESSION_VARS
 $HTTP_SESSION_VARS["spongebob"] = "He's got square pants.";
+?>
 ]]>
       </programlisting>
      </informalexample>
@@ -102,8 +110,9 @@ $HTTP_SESSION_VARS["spongebob"] = "He's got square pants.";
      </para>
     </note>
     <para>
-     See also <function>session_is_registered</function> and
-     <function>session_unregister</function>.
+     See also <function>session_is_registered</function>,
+     <function>session_unregister</function>, and
+     <link linkend="reserved.variables.session">$_SESSION</link>.
     </para>
    </refsect1>
   </refentry>