[master] 7bd56ff inline the backend stuff again

[Per Buer]

commit 7bd56ffc2a9fbe22c10042b90954c6aedcc2918b
Author: Per Buer <perbu at varnish-software.com>
Date:   Fri Aug 30 09:01:46 2013 +0200

    inline the backend stuff again

diff --git a/doc/sphinx/reference/vcl.rst b/doc/sphinx/reference/vcl.rst
index ab63679..a99f2eb 100644
--- a/doc/sphinx/reference/vcl.rst
+++ b/doc/sphinx/reference/vcl.rst
@@ -27,9 +27,54 @@ When a new configuration is loaded, the varnishd management process
 translates the VCL code to C and compiles it to a shared object which
 is then dynamically linked into the server process.
 
-.. .. include:: ../include/vcl-syntax.rst
+For an overview of the VCL syntax please see the users guide.
+
+
+Backend declarations
+--------------------
+
+A backend declaration creates and initializes a named backend object:
+::
+
+  backend www {
+    .host = "www.example.com";
+    .port = "http";
+  }
+
+The backend object can later be used to select a backend at request time:
+::
+
+  if (req.http.host ~ "(?i)^(www.)?example.com$") {
+    set req.backend = www;
+  }
+
+To avoid overloading backend servers, .max_connections can be set to
+limit the maximum number of concurrent backend connections.
+
+The timeout parameters can be overridden in the backend declaration.
+The timeout parameters are .connect_timeout for the time to wait for a
+backend connection, .first_byte_timeout for the time to wait for the
+first byte from the backend and .between_bytes_timeout for time to
+wait between each received byte.
+
+These can be set in the declaration like this:
+::
+
+  backend www {
+    .host = "www.example.com";
+    .port = "http";
+    .connect_timeout = 1s;
+    .first_byte_timeout = 5s;
+    .between_bytes_timeout = 2s;
+  }
+
+To mark a backend as unhealthy after number of items have been added
+to its saintmode list ``.saintmode_threshold`` can be set to the maximum
+list size. Setting a value of 0 disables saint mode checking entirely
+for that backend.  The value in the backend declaration overrides the
+parameter.
+
 
-.. include:: ../include/vcl-backends.rst
 
 .. _ref-vcl-director: