------------------------------------------------------------
revno: 13666
revision-id: squid3@treenet.co.nz-20141121093616-qxbj1bq2zmsx1u4y
parent: squid3@treenet.co.nz-20141121093155-pl1an0kjpl0p8kpw
fixes bug: http://bugs.squid-cache.org/show_bug.cgi?id=3902
committer: Amos Jeffries <squid3@treenet.co.nz>
branch nick: 3.5
timestamp: Fri 2014-11-21 01:36:16 -0800
message:
  Bug 3902: Docs: external_acl_type cache hash key
------------------------------------------------------------
# Bazaar merge directive format 2 (Bazaar 0.90)
# revision_id: squid3@treenet.co.nz-20141121093616-qxbj1bq2zmsx1u4y
# target_branch: http://bzr.squid-cache.org/bzr/squid3/3.5
# testament_sha1: f2ce17b257920254654ca2aa899b86a477bee034
# timestamp: 2014-11-21 09:37:29 +0000
# source_branch: http://bzr.squid-cache.org/bzr/squid3/3.5
# base_revision_id: squid3@treenet.co.nz-20141121093155-\
#   pl1an0kjpl0p8kpw
# 
# Begin patch
=== modified file 'src/cf.data.pre'
--- src/cf.data.pre	2014-11-21 09:25:14 +0000
+++ src/cf.data.pre	2014-11-21 09:36:16 +0000
@@ -629,31 +629,44 @@
 
 	  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.
-	  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
@@ -775,8 +788,8 @@
 	  		%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.