diff --git a/functions/session.xml b/functions/session.xml
index cd899411dc..8bfbf225d6 100644
--- a/functions/session.xml
+++ b/functions/session.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.59 $ -->
+<!-- $Revision: 1.60 $ -->
  <reference id="ref.session">
   <title>Session handling functions</title>
   <titleabbrev>Sessions</titleabbrev>
@@ -357,13 +357,21 @@ To continue, <A HREF="nextpage.php?<?=SID?>">click here</A>
     <simpara>
      <function>session_start</function> creates a session (or resumes
      the current one based on the session id being passed via a GET
-     variable or a cookie).</simpara>
+     variable or a cookie).
+    </simpara>
+    <simpara>
+     If you want to use a named session, you must call
+     <function>session_name</function> before calling
+     <function>session_start</function>.
+    </simpara>
     <simpara>
      This function always returns &true;.
     </simpara>
     <note>
      <para>
-      This function was added in PHP 4.0.
+      If you are using cookie-based sessions, you must call
+      <function>session_start</function> before anything is output to the
+      browser.
      </para>
     </note>
    </refsect1>