[master] f03a993 4.0 updates

[Per Buer]

commit f03a993b0f04894f99d8931c06eaabdcb60c694d
Author: Per Buer <perbu at varnish-software.com>
Date:   Fri Feb 21 12:07:48 2014 +0100

    4.0 updates

diff --git a/doc/sphinx/users-guide/vcl-variables.rst b/doc/sphinx/users-guide/vcl-variables.rst
index 15999cc..f21e30e 100644
--- a/doc/sphinx/users-guide/vcl-variables.rst
+++ b/doc/sphinx/users-guide/vcl-variables.rst
@@ -11,15 +11,17 @@ In VCL, there several important objects.
  do on or with the req object.
 
 *bereq*
- The backend request object. 
+ The backend request object. Varnish contructs this before sending it to the 
+ backend.
 
 *beresp*
- The backend respons object. It contains the headers of the object 
- coming from the backend. Most of the work you do in vcl_fetch you 
- do on the beresp object.
+ The backend response object. It contains the headers of the object 
+ coming from the backend. If you want to modify the reponse coming from the 
+ server you modify this object in vcl_backend_reponse. 
 
 *resp*
- The HTTP response right before it is delivered to the client. 
+ The HTTP response right before it is delivered to the client. It is
+ typically modified in vcl_deliver.
 
 *obj* 
  The object as it is stored in cache. Mostly read only.