Author: Adrian Chadd <adrian@squid-cache.org>

Add in some better documentation for override-expire.

Attempt to clearly document exactly what it does - in this instance, it
enforces min age and doesn't allow the admin to enforce max-age -
ie, truncate staleness.

diff --git a/src/cf.data.pre b/src/cf.data.pre
index 382f84dfeee6c2ddefdba93ccd83efef75fd04ba..70fb7b6b7b264dc9246dc1e4dc323e8e02928ec7 100644 (file)
--- a/src/cf.data.pre
+++ b/src/cf.data.pre
@@ -2960,6 +2960,11 @@ DOC_START
                VIOLATES the HTTP standard.  Enabling this feature
                could make you liable for problems which it causes.
 
+               Note: override-expire does not enforce staleness - it only extends
+               freshness / min. If the server returns a Expires time which
+               is longer than your max time, Squid will still consider
+               the object fresh for that period of time.
+
                override-lastmod enforces min age even on objects
                that were modified recently.