[master] 03ba4e4fb Add more release notes for 2018-09 to 'Upgrading'.

[Geoff Simmons]

commit 03ba4e4fbef6334b4db64618889955a36986523c
Author: Geoff Simmons <geoff at uplex.de>
Date:   Mon Sep 10 08:26:20 2018 +0200

    Add more release notes for 2018-09 to 'Upgrading'.

diff --git a/doc/sphinx/whats-new/upgrading-6.1.rst b/doc/sphinx/whats-new/upgrading-6.1.rst
index 7d3c06168..2b09166d9 100644
--- a/doc/sphinx/whats-new/upgrading-6.1.rst
+++ b/doc/sphinx/whats-new/upgrading-6.1.rst
@@ -156,7 +156,15 @@ Other changes
 
   * **XXX**
 
-* ``varnishlog(1)``:
+* ``varnishlog(1)`` and ``vsl(7)``:
+
+  * The contents of ``FetchError`` log entries have been improved to
+    give better human-readable diagnostics for certain classes of
+    backend fetch failures.
+
+  * ``Debug`` log entries may also give more diagnostic information
+    about backend fetch failures and session accept failures (failure
+    to accept a client connection).
 
   * When a backend is unhealthy, ``Backend_health`` now reports some
     diagnostic information in addition to the HTTP response and timing
@@ -166,7 +174,9 @@ Other changes
     name without the VCL prefix (as appears otherwise for backend
     naming).
 
-  * **XXX**
+  * Added the log entry tag ``Filters``, which gives a list of the
+    filters applied to a response body (see ``beresp.filters``
+    discussed above).
 
 * ``varnishadm(1)`` and ``varnish-cli(7)``
 
@@ -184,6 +194,11 @@ Other changes
     A JSON response in the CLI always includes a timestamp (epoch time in
     seconds with millisecond precision).
 
+  * The ``backend.list`` command now lists both directors and
+    backends, with their health status. The command now has a ``-v``
+    option for verbose output, in which detailed health states for
+    each backend/director are displayed.
+
 * ``varnishstat(1)`` and ``varnish-counters(7)``:
 
   * We have added a number of counters to the ``VBE.*`` group to help
@@ -264,8 +279,16 @@ Other changes
     connection each time. This makes the test run faster and use fewer
     ephemeral ports.
 
+  * Added the ``-need-bytes`` argument for the ``process`` command,
+    see :ref:`vtc(7)`.
+
   * **XXX**
 
+* ``varnishhist(1)``:
+
+  * The ``-P min:max`` command-line parameters are now optional,
+    see :ref:`varnishhist(1)`.
+
 * For all of the utilities that access the Varnish log --
   ``varnishlog(1)``, ``varnishncsa(1)``, ``varnishtop(1)`` and
   ``varnishhist(1)`` -- it is now possible to set multiple ``-I`` and
@@ -302,6 +325,12 @@ Other changes
   * We have fixed a bug that had limited the precision available for
     the ``INT`` data type, so you now get the full 64 bits.
 
+  * Portions of what had previously been declared in
+    ``cache_director.h`` have been moved into ``vrt.h``, constituting
+    the public API for directors. The remainder in
+    ``cache_director.h`` is not public, and should not be used by a
+    VMOD intended for VRT ABI compatibility.
+
   * Python 3 is now preferred in builds, and will likely be required
     in future versions.