From b607876481a75f3dfd2e205f7e70977f285efcc3 Mon Sep 17 00:00:00 2001
From: Hartmut Holzgraefe <hholzgra@php.net>
Date: Wed, 20 Jun 2001 17:21:08 +0000
Subject: [PATCH] session_end() and session_readonly() added

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@49900 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/session.xml | 54 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 53 insertions(+), 1 deletion(-)

diff --git a/functions/session.xml b/functions/session.xml
index d4e82b08b0..1383cf3383 100644
--- a/functions/session.xml
+++ b/functions/session.xml
@@ -1,7 +1,7 @@
  <reference id="ref.session">
   <title>Session handling functions</title>
   <titleabbrev>Sessions</titleabbrev>
-
+	
   <partintro>
    <para>
     Session support in PHP consists of a way to preserve certain data
@@ -937,6 +937,58 @@ echo "The cache limiter is now set to $cache_limiter&lt;p&gt;";
    </refsect1>
   </refentry>
 
+  <refentry id="function.session-end">
+   <refnamediv>
+    <refname>session_end</refname>
+    <refpurpose>Write session data and end session</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>void <function>session_end</function></funcdef>
+      <void/>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     End the current session and store session data.
+    </para>
+    <para>
+     Session data is usually stored after your script terminated
+     without the need to call <function>session_end</function>, but as
+     session data is locked to prevend concurrent writes only one
+     script may operate on a session at any time. When using framesets
+     together with sessions you will experience the frames loading one
+     by one due to this locking. You can reduce the time needed to
+     laod all the frames by ending the session as soon as all changes
+     to session variables are done.
+    </para>
+    <para>
+     See also: <function>session_readonly</function>.
+    </para>
+   </refsect1>
+  </refentry>
+
+  <refentry id="function.session-readonly">
+   <refnamediv>
+    <refname>session_readonly</refname>
+    <refpurpose>Begin session - reinitializes freezed variables, but no writeback on request end</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>void <function>session_readonly</function></funcdef>
+      <void/>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     Read in session data without locking the session data. Changing
+     session data is not possible, but frameset performance will be improved.
+    </para>
+   </refsect1>
+  </refentry>
+
  </reference>
 
 <!-- Keep this comment at the end of the file