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 92d31bad33499694b33274515b11a4ac63265c78..0bebbb7373c9b7dec1c319df6d8d7b8eb53ceaa6 100644 (file)
--- a/src/cf.data.pre
+++ b/src/cf.data.pre
@@ -2929,6 +2929,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.