Bug 3902: Docs: external_acl_type cache hash key

diff --git a/src/cf.data.pre b/src/cf.data.pre
index 8edd21fad666a5fcfdc683b58a6f5fcc4680188c..0757c4b4d0ad8ec1b4a9749b9ce369c079ef7ed4 100644 (file)
--- a/src/cf.data.pre
+++ b/src/cf.data.pre
@@ -634,35 +634,49 @@ DOC_START
 
          ttl=n         TTL in seconds for cached results (defaults to 3600
                        for 1 hour)
+
          negative_ttl=n
                        TTL for cached negative lookups (default same
                        as ttl)
+
+         grace=n       Percentage remaining of TTL where a refresh of a
+                       cached entry should be initiated without needing to
+                       wait for a new reply. (default is for no grace period)
+
+         cache=n       Limit the result cache size, default is 262144.
+                       The expanded FORMAT value is used as the cache key, so
+                       if the details in FORMAT are highly variable a larger
+                       cache may be needed to produce reduction in helper load.
+
          children-max=n
                        Maximum number of acl helper processes spawned to service
                        external acl lookups of this type. (default 20)
+
          children-startup=n
                        Minimum number of acl helper processes to spawn during
                        startup and reconfigure to service external acl lookups
                        of this type. (default 0)
+
          children-idle=n
                        Number of acl helper processes to keep ahead of traffic
                        loads. Squid will spawn this many at once whenever load
                        rises above the capabilities of existing processes.
                        Up to the value of children-max. (default 1)
+
          concurrency=n concurrency level per process. Only used with helpers
                        capable of processing more than one query at a time.
+
          queue-size=N  The queue-size= option sets the maximum number of queued
                        requests. If the queued requests exceed queue size 
-                       the acl ignored.
+                       the acl is ignored.
                        The default value is set to 2*children-max.
-         cache=n       limit the result cache size, default is 262144.
-         grace=n       Percentage remaining of TTL where a refresh of a
-                       cached entry should be initiated without needing to
-                       wait for a new reply. (default is for no grace period)
-         protocol=2.5  Compatibility mode for Squid-2.5 external acl helpers
+
+         protocol=2.5  Compatibility mode for Squid-2.5 external acl helpers.
+
          ipv4 / ipv6   IP protocol used to communicate with this helper.
                        The default is to auto-detect IPv6 and use it when available.
 
+
        FORMAT specifications
 
          %LOGIN        Authenticated user login name
@@ -784,8 +798,8 @@ DOC_START
                        %ea in logformat specifications.
 
          clt_conn_tag= Associates a TAG with the client TCP connection.
-                       Please see url_rewrite_program related documentation for
-                       this kv-pair.
+                       Please see url_rewrite_program related documentation
+                       for this kv-pair.
 
        Any keywords may be sent on any response whether OK, ERR or BH.