[master] d1ac4b2 Editorial: move docs about changes in VSL Hit* output to the section about varnishlog(1).

[Geoff Simmons]

commit d1ac4b2677044f2c87b41f48938c8de43475600d
Author: Geoff Simmons <geoff at uplex.de>
Date:   Wed Sep 13 13:44:38 2017 +0200

    Editorial: move docs about changes in VSL Hit* output to the section
    about varnishlog(1).

diff --git a/doc/sphinx/whats-new/upgrading-5.2.rst b/doc/sphinx/whats-new/upgrading-5.2.rst
index 53291e4..3aee8c2 100644
--- a/doc/sphinx/whats-new/upgrading-5.2.rst
+++ b/doc/sphinx/whats-new/upgrading-5.2.rst
@@ -83,19 +83,6 @@ See :ref:`vmod_blob(3)`, :ref:`vmod_purge(3)` and
 Other changes
 =============
 
-* VSL
-
-The ``Hit``, ``HitMiss`` and ``HitPass`` log records grew an additional
-field with the remaining TTL of the object at the time of the lookup.
-While this should greatly help troubleshooting, this might break tools
-relying on those records to get the VXID of the object hit during lookup.
-
-Instead of using ``Hit``, such tools should now use ``Hit[1]``, and the
-same applies to ``HitMiss`` and ``HitPass``.
-
-The ``Hit`` record also grew two more fields for the grace and keep periods.
-This should again be useful for troubleshooting.
-
 * ``varnishstat(1)``:
 
   * *XXX: changes due to new VSC/VSM*
@@ -104,6 +91,20 @@ This should again be useful for troubleshooting.
 
 * ``varnishlog(1)``:
 
+  * The ``Hit``, ``HitMiss`` and ``HitPass`` log records grew an
+    additional field with the remaining TTL of the object at the time
+    of the lookup.  While this should greatly help troubleshooting,
+    this might break tools relying on those records to get the VXID of
+    the object hit during lookup.
+
+    Instead of using ``Hit``, such tools should now use ``Hit[1]``,
+    and the same applies to ``HitMiss`` and ``HitPass``.
+
+    The ``Hit`` record also grew two more fields for the grace and
+    keep periods.  This should again be useful for troubleshooting.
+
+    See :ref:`vsl(7)`.
+
   * *XXX: changes due to new VSC/VSM*
 
   * *XXX: ...*