[master] bed7a98 Prepare for 5.2-RC1

[Poul-Henning Kamp]

commit bed7a98a296bc7da9524067987858fbd1dc633f0
Author: Poul-Henning Kamp <phk at FreeBSD.org>
Date:   Mon Sep 4 12:18:28 2017 +0000

    Prepare for 5.2-RC1

diff --git a/doc/changes.rst b/doc/changes.rst
index bed6ac5..ec24013 100644
--- a/doc/changes.rst
+++ b/doc/changes.rst
@@ -2,6 +2,10 @@
 Varnish Cache Trunk (ongoing)
 =============================
 
+==================================
+Varnish Cache 5.2-RC1 (2017-09-04)
+==================================
+
 Usage
 -----
 
@@ -28,9 +32,12 @@ VCL
 C APIs (for vmod and utility authors)
 -------------------------------------
 
-* ``VSM_Name()`` returns the -i argument name, rather than the -n name.
+* The VSM API for accessing the shared memory segment has been
+  totally rewritten.  Things should be simpler and more general.
 
-* ``VUT.name`` is gone, use ``VSM_Name(VUT.vsm)``
+* VSC shared memory layout has changed and the VSC API updated
+  to match it.  This paves the way for user defined VSC counters
+  in VMODS and later possibly also in VCL.
 
 * New vmod vtc for advanced varnishtest usage (#2276)