[master] d109b419c doc: Mention remaining VCL changes
Dridi Boukelmoune
dridi.boukelmoune at gmail.com
Fri Sep 11 14:20:06 UTC 2020
commit d109b419cda9dbf7fc6c12eb50d80d5d2452e9aa
Author: Dridi Boukelmoune <dridi.boukelmoune at gmail.com>
Date: Fri Sep 11 16:09:15 2020 +0200
doc: Mention remaining VCL changes
Leaving out any change that is solely a bug fix on purpose.
diff --git a/doc/sphinx/whats-new/changes-trunk.rst b/doc/sphinx/whats-new/changes-trunk.rst
index da9782274..8a0e637f2 100644
--- a/doc/sphinx/whats-new/changes-trunk.rst
+++ b/doc/sphinx/whats-new/changes-trunk.rst
@@ -38,6 +38,21 @@ Changes to VCL
VCL variables
~~~~~~~~~~~~~
+A new ``obj.can_esi`` variable has been added to identify whether the response
+can be ESI processed.
+
+Once ``resp.filters`` is explicitly set, trying to set a ``resp.do_*`` field
+results in a VCL failure. The same rule applies to ``beresp.filters`` and
+``beresp.do_*`` fields.
+
+The ``BACKEND`` VCL type now has a ``.resolve()`` method to find the effective
+backend directly from VCL. When a director is selected, the resolution would
+otherwise be delayed until after returning from ``vcl_backend_fetch`` or
+``vcl_pipe``::
+
+ # eager backend selection
+ set bereq.backend = bereq.backend.resolve();
+
It is now possible to manually set a ``Connection: close`` header in
``beresp`` to signal that the backend connection shouldn't be recycled.
This might help dealing with backends that would under certain circumstances
@@ -57,11 +72,16 @@ header::
}
}
-**XXX new, deprecated or removed variables, or changed semantics**
-
Other changes to VCL
~~~~~~~~~~~~~~~~~~~~
+A failure in ``vcl_recv`` could resume execution in ``vcl_hash`` before
+effectively ending the transaction, this has been corrected. A failure in
+``vcl_recv`` is now definitive.
+
+There is a new syntax for ``BLOB`` literals: ``:<base64>:``. This syntax is
+also used to automatically cast a blob into a string.
+
VMODs
=====
More information about the varnish-commit
mailing list