[master] e291bfaa5 Document vmod cookie VCL_REGEX changes

[Nils Goroll]

commit e291bfaa5250b86cad600479284108bbe7458161
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Sun Mar 14 16:24:21 2021 +0100

    Document vmod cookie VCL_REGEX changes
    
    Noted by Simon Vikström, thank you
    
    Closes #3551

diff --git a/doc/changes.rst b/doc/changes.rst
index 05d488f79..c9a251986 100644
--- a/doc/changes.rst
+++ b/doc/changes.rst
@@ -352,6 +352,16 @@ Varnish Cache Next (2021-03-15)
   have been removed, because they are not required and their use was
   probably wrong anyway.
 
+* The ``filter_re``, ``keep_re`` and ``get_re`` functions from the
+  bundled ``cookie`` vmod have been changed to take the ``VCL_REGEX``
+  type. This implies that their regular expression arguments now need
+  to be literal, whereas before they could be taken from some other
+  variable or function returning ``VCL_STRING``.
+
+  Note that these functions never actually handled _dynamic_ regexen,
+  the string passed with the first call was compiled to a regex, which
+  was then used for the lifetime of the respective VCL.
+
 * The ``%{X}T`` format has been added to ``varnishncsa``, which
   generalizes ``%D`` and ``%T``, but also support milliseconds
   (``ms``) output.