[master] 1bddcfa Document hit_for_pass in the tutorial

[Kristian Lyngstøl]

commit 1bddcfa742f5a48808429681b5df21520fadd0b4
Author: Kristian Lyngstol <kristian at bohemians.org>
Date:   Thu Sep 1 15:20:36 2011 +0200

    Document hit_for_pass in the tutorial

diff --git a/doc/sphinx/tutorial/vcl.rst b/doc/sphinx/tutorial/vcl.rst
index f52c1ed..3ed78c5 100644
--- a/doc/sphinx/tutorial/vcl.rst
+++ b/doc/sphinx/tutorial/vcl.rst
@@ -58,7 +58,15 @@ The most common actions to return are these:
 *pass*
  When you return pass the request and subsequent response will be passed to
  and from the backend server. It won't be cached. pass can be returned from
- both vcl_recv and vcl_fetch.
+ vcl_recv
+
+*hit_for_pass*
+  Similar to pass, but accessible from vcl_fetch. Unlike pass, hit_for_pass
+  will create a hitforpass object in the cache. This has the side-effect of
+  caching the decision not to cache. This is to allow would-be uncachable
+  requests to be passed to the backend at the same time. The same logic is
+  not necessary in vcl_recv because this happens before any potential
+  queueing for an object takes place.
 
 *lookup*
   When you return lookup from vcl_recv you tell Varnish to deliver content