changes: First sweep since 7.1.0

doc/changes.rst

@@ -35,10 +35,88 @@ release process.
 Varnish Cache NEXT (2022-09-15)
 ===============================
 
+* Functions ``VRT_AddVDP()``, ``VRT_AddVFP()``, ``VRT_RemoveVDP()`` and
+  ``VRT_RemoveVFP()`` are deprecated.
+
 * Cookie headers generated by vmod_cookie no longer have a spurious trailing
   semi-colon (``';'``) at the end of the string. This could break VCL relying
   on the previous incorrect behavior.
 
+* Prototypical Varnish Extensions (VEXT). Similar to VMODs, a VEXT is loaded
+  by the cache process. Unlike VMODs that have the combined lifetime of all
+  the VCLs that reference them, a VEXT has the lifetime of the cache process
+  itself. There are no built-in extensions so far.
+
+* The VCC (compilation) process no longer loads VMODs with ``dlopen(3)`` to
+  collect their metadata.
+
+* The parameter ``tcp_keepalive_time`` is supported on MacOS.
+
+* Duration parameters can optionally take a unit, with the same syntax as
+  duration units in VCL. Example: ``param.set default_grace 1h``.
+
+* New ``"B"`` string for the package branch in ``VCS_String()``. For the 7.2.0
+  version, it would yield the 7.2 branch.
+
+* The Varnish version and branch are available in ``varnishtest`` through the
+  ``${pkg_version}`` and ``${pkg_branch}`` macros.
+
+* New ``${topsrc}`` macro in ``varnishtest -i`` mode.
+
+* New ``process pNAME -match-text`` command in ``varnishtest`` to expect
+  text matching a regular expression on screen.
+
+* New ``filewrite [-a]`` command in ``varnishtest`` to put or append a string
+  into a file.
+
+* The new ``vcc_feature`` bits parameter replaces previous ``vcc_*`` boolean
+  parameters. The latter still exist as deprecated aliases.
+
+* The ``-k`` option from ``varnishlog`` is now supported by ``varnishncsa``.
+
+* New functions ``std.now()`` and ``std.timed_call()`` in vmod_std.
+
+* New ``MAIN.shm_bytes`` counter.
+
+* A ``req.http.via`` header is set before entering ``vcl_recv``. Via headers
+  are generated using the ``server.identity`` value. It defaults to the host
+  name and can be turned into a pseudonym with the ``varnishd -i`` option.
+  Via headers are appended in both directions, to work with other hops that
+  may advertise themselves.
+
+* The ``server.identity`` syntax is now limited to a "token" as defined in
+  the HTTP grammar to be suitable for Via headers.
+
+* In ``varnishtest`` a Varnish instance will use its VTC instance name as its
+  instance name (``varnishd -i``) by default for predictable Via headers in
+  test cases.
+
+* VMOD and VEXT authors can use functions from ``vnum.h``.
+
+* The termination rules for ``WRK_BgThread()`` were relaxed to allow VMODs to
+  use it.
+
+* The ``Begin`` log record has a 4th field for subtasks like ESI sub-requests.
+
+* The ``-E`` option for log utilities now works as documented, with any type
+  of sub-task based on the ``Begin[4]`` field. This covers ESI like before,
+  and sub-tasks spawned by VMODs (provided that they log the new field).
+
+* No more ``req.http.transfer-encoding`` for ESI sub-requests.
+
+* New ``tools/coccinelle/vcocci.sh`` refactoring script for internal use.
+
+* The thread pool reserve is now limited to tasks that can be queued. A
+  backend background fetch is no longer eligible for queueing. It would
+  otherwise slow a grace hit down significantly when thread pools are
+  saturated.
+
+* The unused ``fetch_no_thread`` counter was renamed to ``bgfetch_no_thread``
+  because regular backend fetch tasks are always scheduled.
+
+* There is a new ``contrib/`` directory in the Varnish source tree. The first
+  contribution is a ``varnishstatdiff`` script.
+
 ================================
 Varnish Cache 7.1.0 (2022-03-15)
 ================================