Mailing List Archive

[master] 94af15e8e doc: Mention the VCL standalone return statement
commit 94af15e8ed993377ac7cae187f3e70ffb33c9d42
Author: Dridi Boukelmoune <dridi.boukelmoune@gmail.com>
Date: Tue Jan 26 10:30:31 2021 +0100

doc: Mention the VCL standalone return statement

Salvaged from #3503

diff --git a/doc/sphinx/reference/vcl.rst b/doc/sphinx/reference/vcl.rst
index 00be68429..9dc04d6ca 100644
--- a/doc/sphinx/reference/vcl.rst
+++ b/doc/sphinx/reference/vcl.rst
@@ -434,6 +434,17 @@ The ongoing ``vcl_*`` subroutine execution ends when a
The *<action>* specifies how execution should proceed. The context
defines which actions are available.

+It is possible to exit a subroutine that is not part of the built-in ones
+using a simple ``return`` statement without specifying an action. It exits
+the subroutine without transitioning to a different state::
+
+ sub filter_cookies {
+ if (!req.http.cookie) {
+ return;
+ }
+ # complex cookie filtering
+ }
+
Multiple subroutines
~~~~~~~~~~~~~~~~~~~~

@@ -538,7 +549,7 @@ HISTORY
VCL was developed by Poul-Henning Kamp in cooperation with Verdens
Gang AS, Redpill Linpro and Varnish Software. This manual page is
written by Per Buer, Poul-Henning Kamp, Martin Blix Grydeland,
-Kristian Lyngstøl, Lasse Karstensen and possibly others.
+Kristian Lyngstøl, Lasse Karstensen and others.

COPYRIGHT
=========
_______________________________________________
varnish-commit mailing list
varnish-commit@varnish-cache.org
https://www.varnish-cache.org/lists/mailman/listinfo/varnish-commit