Explain the meaning of obj.valid and obj.cacheable.

git-svn-id: svn+ssh://projects.linpro.no/svn/varnish/trunk@1819 d4fa192b-c00b-0410-8231-f00ffab90ce4

diff --git a/varnish-cache/man/vcl.7 b/varnish-cache/man/vcl.7
index 4ce39153b6e4905f436248288f3667a7f636a375..0b386729e1d0a6a4e46cff9d961547c8b678723c 100644 (file)
--- a/varnish-cache/man/vcl.7
+++ b/varnish-cache/man/vcl.7
@@ -424,10 +424,17 @@ The HTTP status code returned by the server.
 .It Va obj.response
 The HTTP status message returned by the server.
 .It Va obj.valid
-True if the object was successfully retrieved.
+True if the request resulted in a valid HTTP response.
 .It Va obj.cacheable
-True if the object is cacheable.
-.\" XXX what are the criteria?
+True if the request resulted in a cacheable response.
+.\" see cache_center.c and rfc2616.c for details
+A response is considered cacheable if it is valid (see above), the
+HTTP status code is 200, 203, 300, 301, 302, 404 or 410 and it has a
+non-zero time-to-live when
+.Cm Expires
+and
+.Cm Cache-Control
+headers are taken into account.
 .It Va obj.ttl
 The object's remaining time to live, in seconds.
 .It Va obj.lastuse