[master] fa920eb05 document #2951

[Nils Goroll]

commit fa920eb053a8c36d2bef3f463ed0238659606f8a
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Mon Apr 15 16:04:44 2019 +0200

    document #2951

diff --git a/doc/changes.rst b/doc/changes.rst
index 4e7494225..046c5e1a8 100644
--- a/doc/changes.rst
+++ b/doc/changes.rst
@@ -26,6 +26,23 @@ http://varnish-cache.org/docs/trunk/whats-new/index.html and via
 individual releases. These documents are updated as part of the
 release process.
 
+================================
+NEXT (2019-09-15)
+================================
+
+* Synthetic objects created from ``vcl_backend_error {}`` now replace
+  existing stale objects as ordinary backend fetches would, unless:
+
+  - abandoning the bereq or
+
+  - leaving ``vcl_backend_error {}`` with ``return (deliver) and
+    ``beresp.ttl == 0s`` or
+
+  - there is a waitinglist on the object, in which case, by default,
+    the synthetic object is created with ``ttl = 1s`` / ``grace = 5s``
+    / ``keep = 5s`` avoid hammering on failing backends
+    (note this is existing behavior).
+
 ================================
 Varnish Cache 6.2.0 (2019-03-15)
 ================================