Improvements in transformation cache (add options, document).

Update CHANGES.

doc/modsecurity2-apache-reference.xml

@@ -783,6 +783,59 @@ SecAuditLogStorageDir logs/audit
       </orderedlist>
     </section>
 
+    <section>
+      <title><literal>SecCacheTransformations</literal></title>
+
+      <para><emphasis role="bold">Description:</emphasis> Controls caching of
+      transformations.</para>
+
+      <para><emphasis role="bold">Syntax:</emphasis> <literal
+      moreinfo="none">SecCacheTransformations On|Off
+      [options]</literal></para>
+
+      <para><emphasis role="bold">Example Usage:</emphasis> <literal
+      moreinfo="none">SecCacheTransformations On
+      "minlen:64,maxlen:0"</literal></para>
+
+      <para><emphasis role="bold">Processing Phase:</emphasis> N/A</para>
+
+      <para><emphasis role="bold">Scope:</emphasis> Any</para>
+
+      <para><emphasis role="bold">Dependencies/Notes:</emphasis> N/A</para>
+
+      <para>First parameter:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><literal moreinfo="none">On</literal> - cache transformations
+          (per transaction, per phase) allowing identical transformations to
+          be performed only once. (default)</para>
+        </listitem>
+
+        <listitem>
+          <para><literal moreinfo="none">Off</literal> - do not cache any
+          transformations, forcing all transformations to be performed for
+          each rule executed.</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>The following options are allowed (comma seperated):</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><literal moreinfo="none">minlen:N</literal> - do not cache the
+          transformation if the value's length is less than N bytes. (default:
+          15)</para>
+        </listitem>
+
+        <listitem>
+          <para><literal moreinfo="none">maxlen:N</literal> - do not cache the
+          transformation if the value's length is more than N bytes. A zero
+          value is interpreted as "unlimited". (default: 0)</para>
+        </listitem>
+      </itemizedlist>
+    </section>
+
     <section>
       <title><literal>SecChrootDir</literal></title>
 
@@ -4666,4 +4719,4 @@ SecAction "pass,setvar:'tx.allowed_methods=get,post,head'"
 SecRule REQUEST_METHOD "!<emphasis role="bold">@within %{tx.allowed_methods}</emphasis>" t:lowercase,deny,status:403</programlisting>
     </section>
   </section>
-</article>
+</article>