Merged revisions 1819 via svnmerge from

svn+ssh://projects.linpro.no/svn/varnish/trunk/varnish-cache

........
  r1819 | des | 2007-08-09 16:58:56 +0200 (Thu, 09 Aug 2007) | 2 lines
  
  Explain the meaning of obj.valid and obj.cacheable.
........


git-svn-id: http://www.varnish-cache.org/svn/branches/1.1@1820 d4fa192b-c00b-0410-8231-f00ffab90ce4

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