From 16e5856b7c59c0d94f724cadaa91aba6700ef730 Mon Sep 17 00:00:00 2001
From: Hannes Magnusson <bjori@php.net>
Date: Sun, 21 Jun 2009 20:16:32 +0000
Subject: [PATCH] Document the valid limiters

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@282527 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../functions/session-cache-limiter.xml       | 62 ++++++++++++++++++-
 reference/session/ini.xml                     |  4 +-
 2 files changed, 63 insertions(+), 3 deletions(-)

diff --git a/reference/session/functions/session-cache-limiter.xml b/reference/session/functions/session-cache-limiter.xml
index b59c74ef0d..162e1ba929 100644
--- a/reference/session/functions/session-cache-limiter.xml
+++ b/reference/session/functions/session-cache-limiter.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-cache-limiter">
  <refnamediv>
   <refname>session_cache_limiter</refname>
@@ -51,6 +51,66 @@
        If <parameter>cache_limiter</parameter> is specified, the name of the
        current cache limiter is changed to the new value.
       </para>
+      <table>
+       <title>Possible values</title>
+       <tgroup cols="2">
+        <thead>
+         <row>
+          <entry>Value</entry>
+          <entry>Headers sent</entry>
+         </row>
+        </thead>
+        <tbody>
+         <row>
+          <entry><literal>public</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Expires: (sometime in the future, according session.cache_expires)
+Cache-Control: public, max-age=(sometime in the future, according to session.cache_expire
+Last-Modified: (the timestamp of when the session was last saved)
+]]>
+           </programlisting>
+          </entry>
+         </row>
+         <row>
+          <entry><literal>private_no_expire</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Cache-Control: private, max-age=(session.cache_expire in the future), pre-check=(session.cache_expire in the future)
+Last-Modified: (the timestamp of when the session was last saved)
+]]>
+           </programlisting>
+          </entry>
+         </row>
+         <row>
+          <entry><literal>private</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Expires: Thu, 19 Nov 1981 08:52:00 GMT
+Cache-Control: private, max-age=(session.cache_expire in the future), pre-check=(session.cache_expire in the future)
+Last-Modified: (the timestamp of when the session was last saved)
+]]>
+           </programlisting>
+          </entry>
+         </row>
+         <row>
+          <entry><literal>nocache</literal></entry>
+          <entry>
+           <programlisting role="header">
+<![CDATA[
+Expires: Thu, 19 Nov 1981 08:52:00 GMT
+Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
+Pragma: no-cache
+]]>
+           </programlisting>
+          </entry>
+         </row>
+        </tbody>
+       </tgroup>
+      </table>
      </listitem>
     </varlistentry>
    </variablelist>
diff --git a/reference/session/ini.xml b/reference/session/ini.xml
index 5a5640f867..f2ef58c651 100644
--- a/reference/session/ini.xml
+++ b/reference/session/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.57 $ -->
+<!-- $Revision: 1.58 $ -->
 <section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
  &extension.runtime;
@@ -538,7 +538,7 @@
     <simpara>
      <literal>session.cache_limiter</literal> specifies cache
      control method to use for session pages
-     (none/nocache/private/private_no_expire/public). Defaults to
+     (nocache/private/private_no_expire/public). Defaults to
      <literal>nocache</literal>. See also
      <function>session_cache_limiter</function>.
     </simpara>