From: Amos Jeffries Date: Sun, 5 Feb 2023 21:00:38 +0000 (+0000) Subject: Documentation: Polish "refresh_pattern percent" description (#1260) X-Git-Tag: SQUID_5_8~4 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0d077980672c0433f31ecf7c6e849dd1043c2281;p=thirdparty%2Fsquid.git Documentation: Polish "refresh_pattern percent" description (#1260) The original text contained a "last modification age" typo and was misinterpreted by some admins as if Squid applied the configured percent to the current object age. The text also did not make it clear that the percent-based heuristic is effectively only applied to responses with a Last-Modified header (in addition to the usual "without an explicit expiry time" precondition). --- diff --git a/src/cf.data.pre b/src/cf.data.pre index b9dd307301..46b87c47a2 100644 --- a/src/cf.data.pre +++ b/src/cf.data.pre @@ -6207,9 +6207,9 @@ DOC_START to be erroneously cached unless the application designer has taken the appropriate actions. - 'Percent' is a percentage of the objects age (time since last - modification age) an object without explicit expiry time - will be considered fresh. + 'Percent' is used to compute the max-age value for responses + with a Last-Modified header and no Cache-Control:max-age nor Expires. + Cache-Control:max-age = ( Date - Last-Modified ) * percent 'Max' is an upper limit on how long objects without an explicit expiry time will be considered fresh. The value is also used