[master] a3cc90d3b doc: Mention VSL changes

Dridi Boukelmoune dridi.boukelmoune at gmail.com
Thu Sep 10 13:30:08 UTC 2020

commit a3cc90d3ba15ea9c790354946a63bb53ca3100af
Author: Dridi Boukelmoune <dridi.boukelmoune at gmail.com>
Date:   Thu Sep 10 15:28:42 2020 +0200

    doc: Mention VSL changes

diff --git a/doc/sphinx/whats-new/changes-trunk.rst b/doc/sphinx/whats-new/changes-trunk.rst
index e1b2bb440..b34158668 100644
--- a/doc/sphinx/whats-new/changes-trunk.rst
+++ b/doc/sphinx/whats-new/changes-trunk.rst
@@ -47,7 +47,13 @@ VMODs
-**XXX changes concerning varnishlog(1) and/or vsl(7)**
+The ``BackendReuse`` log record has been retired. It was inconsistently named
+compared to other places like stat counters where we use the words reuse and
+recycle (it should have been named ``BackendRecycle`` if anything).
+The ``BackendOpen`` record can now tell whether the connection to the backend
+was opened or reused from the pool, and the ``BackendClose`` record will tell
+whether the connection was effectively closed or recycled into the pool.
diff --git a/doc/sphinx/whats-new/upgrading-trunk.rst b/doc/sphinx/whats-new/upgrading-trunk.rst
index a38b67457..9922355b4 100644
--- a/doc/sphinx/whats-new/upgrading-trunk.rst
+++ b/doc/sphinx/whats-new/upgrading-trunk.rst
@@ -61,4 +61,16 @@ After::
+If you need to build VSL queries that depend on ``BackendReuse`` you can
+now rely on ``BackendClose``, for example::
+    varnishlog -q 'BackendReuse[2] ~ www'
+The new query would be::
+    varnishlog -q 'BackendClose[2] ~ www and BackendClose[3] eq recycle'

More information about the varnish-commit mailing list