[master] 26baff9 Document status quo regarding req.backend_hint and restarts

[Nils Goroll]

commit 26baff9d140c403623b3ef3f53cd4f775ee26627
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Tue Aug 29 13:04:59 2017 +0200

    Document status quo regarding req.backend_hint and restarts
    
    Related to #2305

diff --git a/doc/sphinx/users-guide/vcl-actions.rst b/doc/sphinx/users-guide/vcl-actions.rst
index 57b2ea8..d26f5c6 100644
--- a/doc/sphinx/users-guide/vcl-actions.rst
+++ b/doc/sphinx/users-guide/vcl-actions.rst
@@ -31,7 +31,8 @@ The most common actions to return are these:
 
 *restart*
   Restart processing of the request. You can restart the processing of
-  the whole transaction. Changes to the `req` object are retained.
+  the whole transaction. Changes to the `req` object are retained, except
+  for `req.backend_hint`, which gets reset to the default backend.
 
 *retry*
   Retry the request against the backend. This can be returned from
diff --git a/lib/libvcc/generate.py b/lib/libvcc/generate.py
index 591e4f7..8bbd1e6 100755
--- a/lib/libvcc/generate.py
+++ b/lib/libvcc/generate.py
@@ -330,6 +330,8 @@ sp_variables = [
 		or the director otherwise.
 		When used in string context, returns the name of the director
 		or backend, respectively.
+		Note: backend_hint gets reset to the default backend by
+		restarts!
 		"""
 	),
 	('req.hash_ignore_busy',