[master] 5e5d254 Document the new return(retry).

[Lasse Karstensen]

commit 5e5d25470863490365c791f13233bb546daab4c6
Author: Lasse Karstensen <lkarsten at varnish-software.com>
Date:   Tue Jul 22 11:28:22 2014 +0200

    Document the new return(retry).
    
    Backend restarts are now return(retry).
    
    Fixes:	#1503

diff --git a/doc/sphinx/whats-new/upgrading.rst b/doc/sphinx/whats-new/upgrading.rst
index f48548f..2eeb2f1 100644
--- a/doc/sphinx/whats-new/upgrading.rst
+++ b/doc/sphinx/whats-new/upgrading.rst
@@ -158,6 +158,18 @@ following has changed:
  - `vcl_hash` must now return `lookup` instead of `hash`
  - `vcl_pass` must now return `fetch` instead of `pass`
 
+
+Backend restarts are now retry
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In 3.0 it was possible to do `return(restart)` after noticing that
+the backend response was wrong, to change to a different backend.
+
+This is now called `return(retry)`, and jumps back up to `vcl_backend_fetch`.
+
+This only influences the backend fetch thread, client-side handling is not affected.
+
+
 default/builtin VCL changes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~