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 d0378bc0fdaca7f4e5d0f3aa71b972c216925400..76c19890eaf492a6919af3cdde851881f6d787d8 100644 (file)
--- a/src/cf.data.pre
+++ b/src/cf.data.pre
@@ -2561,6 +2561,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.