[master] 80e416a objects in VCL. Correct what was wrong and describe obj.

[Per Buer]

commit 80e416aa8e367ed8f3451abe683d73f71adb2652
Author: Per Buer <perbu at varnish-software.com>
Date:   Thu Jun 6 12:46:41 2013 +0200

    objects in VCL.
    Correct what was wrong and describe obj.

diff --git a/doc/sphinx/users-guide/vcl-variables.rst b/doc/sphinx/users-guide/vcl-variables.rst
index 7064bc0..978f5e4 100644
--- a/doc/sphinx/users-guide/vcl-variables.rst
+++ b/doc/sphinx/users-guide/vcl-variables.rst
@@ -2,13 +2,8 @@
 Requests, responses and objects
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In VCL, there are three important data structures. The request, coming
-from the client, the response coming from the backend server and the
-object, stored in cache.
+In VCL, there several important objects.
 
-In VCL you should know the following structures.
-
-.. XXX: Needs verification
 
 *req*
  The request object. When Varnish has received the request the req object is 
@@ -24,5 +19,7 @@ In VCL you should know the following structures.
  do on the beresp object.
 
 *resp*
- The cached object. Mostly a read only object that resides in memory. 
- resp.ttl is writable, the rest is read only.
+ The HTTP response right before it is delivered to the client. 
+
+*obj* 
+ The object as it is stored in cache. Mostly read only.