[master] 8580229 changelog tlc

[Nils Goroll]

commit 8580229767a562bbe3bdd8b80b6a43ab2fa399aa
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Tue Aug 8 11:50:36 2017 +0200

    changelog tlc

diff --git a/doc/changes.rst b/doc/changes.rst
index 5dd2bb1..4432802 100644
--- a/doc/changes.rst
+++ b/doc/changes.rst
@@ -2,25 +2,36 @@
 Varnish Cache Trunk (ongoing)
 =============================
 
-* Default the -i argument to gethostname(3)
-
-* On platforms with setproctitle(3), use the -i argument rather than -n
-
-* VRT_purge fails a transaction if used outside of ``vcl_hit`` and
-  ``vcl_miss`` (#2339)
+Usage
+-----
 
-* VSM_Name() returns the -i argument name, rather than the -n name.
+* The default for the the -i argument is now the hostname as returned
+  by gethostname(3)
 
-* VUT.name is gone, use VSM_Name(VUT.vsm)
+* Where possible (on platforms with setproctitle(3)), the -i argument
+  rather than the -n argument is used for process names
 
-* varnishd honors vcl_path (#2342)
+* varnishd honors ``vcl_path`` (#2342)
 
-* The ``MAIN.s_req`` statistic has been removed, as tt was identical to
+* The ``MAIN.s_req`` statistic has been removed, as it was identical to
   ``MAIN.client_req``. VSM consumers should be changed to use the
   latter if necessary.
 
+VCL
+---
+
+* VRT_purge fails a transaction if used outside of ``vcl_hit`` and
+  ``vcl_miss`` (#2339)
+
 * Added ``bereq.is_bgfetch`` which is true for background fetches.
 
+C APIs (for vmod authors)
+-------------------------
+
+* ``VSM_Name()`` returns the -i argument name, rather than the -n name.
+
+* ``VUT.name`` is gone, use ``VSM_Name(VUT.vsm)``
+
 ================================
 Varnish Cache 5.1.2 (2017-04-07)
 ================================