[4.0] 016d66a Document the new return(retry).

[Lasse Karstensen]

commit 016d66a084a9b2c2840135fce300962d1f1127f6
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 c02ae0f..cb36b08 100644
--- a/doc/sphinx/whats-new/upgrading.rst
+++ b/doc/sphinx/whats-new/upgrading.rst
@@ -164,6 +164,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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~