added session.gc_divisor. Patch by Antony Dovgal

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@148867 c90b9560-bf6c-de11-be94-00142212c4b1

reference/info/functions/ini-set.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.30 $ -->
+<!-- $Revision: 1.31 $ -->
 <!-- splitted from ./en/functions/info.xml, last change in rev 1.23 -->
   <refentry id="function.ini-set">
    <refnamediv>
@@ -652,6 +652,11 @@
            <entry>"1"</entry>
            <entry>PHP_INI_ALL</entry>
           </row>
+          <row>
+           <entry>session.gc_divisor</entry>
+           <entry>"100"</entry>
+           <entry>PHP_INI_ALL</entry>
+          </row>
           <row>
            <entry>session.gc_maxlifetime</entry>
            <entry>"1440"</entry>

reference/session/ini.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.17 $ -->
+<!-- $Revision: 1.18 $ -->
 <section id="session.configuration">
  &reftitle.runtime;
  &extension.runtime;
@@ -40,6 +40,11 @@
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
     </row>
+    <row>
+     <entry>session.gc_divisor</entry>
+     <entry>"100"</entry>
+     <entry>PHP_INI_ALL</entry>
+    </row>
     <row>
      <entry>session.gc_maxlifetime</entry>
      <entry>"1440"</entry>
@@ -264,13 +269,34 @@
    </term>
    <listitem>
     <simpara>
-     <literal>session.gc_probability</literal> specifies the
-     probability that the gc (garbage collection) routine is started
-     on each request in percent. Defaults to <literal>1</literal>.
+     <literal>session.gc_probability</literal> in conjunction with
+     <literal>session.gc_divisor</literal> is used to manage probability
+     that the gc (garbage collection) routine is started.
+     Defaults to <literal>1</literal>. See <link
+     linkend="ini.session.gc-divisor">session.gc_divisor</link> for details.
     </simpara>
    </listitem>
   </varlistentry>
 
+  <varlistentry id="ini.session.gc-divisor">
+   <term>
+    <parameter>session.gc_divisor</parameter>
+    <type>integer</type>
+   </term>
+   <listitem>
+    <simpara>
+     <literal>session.gc_divisor</literal> coupled with 
+     <literal>session.gc_probability</literal> defines the probability 
+     that the gc (garbage collection) process is started on every session 
+     initialization.
+     The probability is calculated by using gc_probability/gc_divisor,
+     e.g. 1/100 means there is a 1% chance that the GC process starts
+     on each request.
+     <literal>session.gc_divisor</literal> defaults to <literal>100</literal>.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  
   <varlistentry id="ini.session.gc-maxlifetime">
    <term>
     <parameter>session.gc_maxlifetime</parameter>