document removed return(miss) from vcl_hit

Ref #2859 #1799

doc/sphinx/whats-new/changes-trunk.rst

@@ -78,6 +78,10 @@ component listening at the socket, or set the socket's permissions,
 after starting Varnish or loading VCL. If the socket still cannot be
 accessed when a fetch is attempted, then the fetch fails.
 
+``return(miss)`` from ``vcl_hit{}`` did never work as intended for the
+common case (it actually turned into a pass), so we now removed it and
+changed the ``builtin.vcl``.
+
 VMODs
 =====
 

doc/sphinx/whats-new/upgrading-trunk.rst

@@ -44,6 +44,15 @@ listening at the socket, or set its permissions, after Varnish starts
 or the VCL is loaded. Backend fetches fail if the socket is not
 accessible by the time the fetch is attempted.
 
+
+``return(miss)`` from ``vcl_hit{}`` is now removed. Options to
+implement similar functionality are:
+
+* a vmod using the new *catflap* mechanism
+
+* ``return (restart)`` from ``vcl_hit{}`` and ``set
+  req.hash_always_miss = true;`` in ``vcl_recv{}`` for the restart.
+
 Runtime parameters
 ==================