From e30bb85206f8cdcb9779bdb1b973115b90eef876 Mon Sep 17 00:00:00 2001
From: Friedhelm Betz <betz@php.net>
Date: Sun, 17 Nov 2002 13:52:05 +0000
Subject: [PATCH] See also's  to related ini-settings added.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@104532 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../functions/session-cache-limiter.xml       | 19 ++++++++++++-------
 .../functions/session-get-cookie-params.xml   | 10 +++++++++-
 reference/session/functions/session-id.xml    |  6 ++++--
 reference/session/functions/session-name.xml  |  8 ++++++--
 .../session/functions/session-save-path.xml   |  8 +++++++-
 .../functions/session-set-cookie-params.xml   | 10 +++++++++-
 .../functions/session-set-save-handler.xml    |  6 +++++-
 7 files changed, 52 insertions(+), 15 deletions(-)

diff --git a/reference/session/functions/session-cache-limiter.xml b/reference/session/functions/session-cache-limiter.xml
index b9db270b9e..1c8206a1d2 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.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.62 -->
   <refentry id="function.session-cache-limiter">
    <refnamediv>
@@ -14,8 +14,8 @@
      </methodsynopsis>
     <para>
      <function>session_cache_limiter</function> returns the name of the
-     current cache limiter. If <parameter>cache_limiter</parameter> is
-     specified, the name of the current cache limiter is changed to the
+     current cache limiter. If <parameter>cache_limiter</parameter>
+     is specified, the name of the current cache limiter is changed to the
      new value.
     </para>
     <para>
@@ -41,17 +41,18 @@
     </note>
     <para>
      The cache limiter is reset to the default value stored in
-     <literal>session.cache_limiter</literal> at request startup time. Thus,
-     you need to call <function>session_cache_limiter</function> for every
+     <link linkend="ini.session.cache-limiter">session.cache_limiter</link>
+     at request startup time. Thus, you need to call
+     <function>session_cache_limiter</function> for every
      request (and before <function>session_start</function> is called).
     </para>
     <example>
-     <title><function>session_cache_limiter</function> examples</title>
+     <title><function>session_cache_limiter</function> example</title>
      <programlisting role="php">
 <![CDATA[
 <?php
 
-# set the cache limiter to 'private'
+/* set the cache limiter to 'private' */
 
 session_cache_limiter('private');
 $cache_limiter = session_cache_limiter();
@@ -61,6 +62,10 @@ echo "The cache limiter is now set to $cache_limiter<p>";
 ]]>
      </programlisting>
     </example>
+    <para>
+     See also the <link linkend="ini.session.cache-limiter">session.cache_limiter</link>
+     configuration directive.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/session/functions/session-get-cookie-params.xml b/reference/session/functions/session-get-cookie-params.xml
index 2261f9119d..f64ddd7edc 100644
--- a/reference/session/functions/session-get-cookie-params.xml
+++ b/reference/session/functions/session-get-cookie-params.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.8 -->
   <refentry id="function.session-get-cookie-params">
    <refnamediv>
@@ -42,6 +42,14 @@
       </listitem>
      </itemizedlist>
     </para>
+    <para>
+     See also the configuration directives
+     <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>,
+     <link linkend="ini.session.cookie-path">session.cookie_path</link>,
+     <link linkend="ini.session.cookie-domain">session.cookie_domain</link>,
+     <link linkend="ini.session.cookie-secure">session.cookie_secure</link>, and
+     <function>session_set_cookie_params</function>.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/session/functions/session-id.xml b/reference/session/functions/session-id.xml
index fdadd2d006..4eabf8b125 100644
--- a/reference/session/functions/session-id.xml
+++ b/reference/session/functions/session-id.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 -->
   <refentry id="function.session-id">
    <refnamediv>
@@ -32,7 +32,9 @@
      linkend="ref.session">Session handling</link>.
     </para>
     <para>
-     See also <function>session_start</function>.
+     See also <function>session_start</function>,
+     <function>session_set_save_handler</function>, and
+     <link linkend="ini.session.save-handler">session.save_handler</link>.
     </para>
    </refsect1>
   </refentry>
diff --git a/reference/session/functions/session-name.xml b/reference/session/functions/session-name.xml
index fcf3726fc5..0919cdd047 100644
--- a/reference/session/functions/session-name.xml
+++ b/reference/session/functions/session-name.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 -->
   <refentry id="function.session-name">
    <refnamediv>
@@ -33,7 +33,7 @@
 <![CDATA[
 <?php
 
-// set the session name to WebsiteID
+/* set the session name to WebsiteID */
 
 $previous_name = session_name("WebsiteID");
 
@@ -42,6 +42,10 @@ echo "The previous session name was $previous_name<p>";
 ]]>
      </programlisting>
     </example>
+    <para>
+     See also the <link linkend="ini.session.name">session.name</link>
+     configuration directive.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/session/functions/session-save-path.xml b/reference/session/functions/session-save-path.xml
index 14a7cabc0f..50798d5f7d 100644
--- a/reference/session/functions/session-save-path.xml
+++ b/reference/session/functions/session-save-path.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 -->
   <refentry id="function.session-save-path">
    <refnamediv>
@@ -16,6 +16,8 @@
      <function>session_save_path</function> returns the path of the current
      directory used to save session data. If <parameter>path</parameter>
      is specified, the path to which data is saved will be changed.
+     <function>session_save_path</function> needs to be called before
+     <function>session_start</function> for that purpose.
      <note>
       <para>
        On some operating systems, you may want to specify a path on a
@@ -25,6 +27,10 @@
       </para>
      </note>
     </para>
+    <para>
+     See also the <link linkend="ini.session.save-path">session.save_path</link>
+     configuration directive.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/session/functions/session-set-cookie-params.xml b/reference/session/functions/session-set-cookie-params.xml
index 160aa7c3c5..b5e0976bde 100644
--- a/reference/session/functions/session-set-cookie-params.xml
+++ b/reference/session/functions/session-set-cookie-params.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 -->
   <refentry id="function.session-set-cookie-params">
    <refnamediv>
@@ -27,6 +27,14 @@
        4.0.4.
      </para>
     </note>
+    <para>
+     See also the configuration directives
+     <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>,
+     <link linkend="ini.session.cookie-path">session.cookie_path</link>,
+     <link linkend="ini.session.cookie-domain">session.cookie_domain</link>,
+     <link linkend="ini.session.cookie-secure">session.cookie_secure</link>, and
+     <function>session_get_cookie_params</function>.
+    </para>
    </refsect1>
   </refentry>
 
diff --git a/reference/session/functions/session-set-save-handler.xml b/reference/session/functions/session-set-save-handler.xml
index d50e06be18..49a36751d8 100644
--- a/reference/session/functions/session-set-save-handler.xml
+++ b/reference/session/functions/session-set-save-handler.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/session.xml, last change in rev 1.23 -->
   <refentry id="function.session-set-save-handler">
    <refnamediv>
@@ -123,6 +123,10 @@ session_start();
       </programlisting>
      </example>
     </para>
+    <para>
+     See also the <link linkend="ini.session.save-handler">session.save_handler</link>
+     configuration directive.
+    </para>
    </refsect1>
   </refentry>