From 0a3427b8d919dbf3f1815183dc20f83100e59d92 Mon Sep 17 00:00:00 2001 From: Amos Jeffries Date: Sun, 5 Feb 2023 21:00:38 +0000 Subject: [PATCH] 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). --- src/cf.data.pre | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/cf.data.pre b/src/cf.data.pre index 5d39f4fbb7..d95f31dc02 100644 --- a/src/cf.data.pre +++ b/src/cf.data.pre @@ -6454,9 +6454,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 -- 2.47.3