[master] 656cabe Expand on backslashes and quoting

Per Buer perbu at varnish-cache.org
Wed Oct 16 10:00:00 CEST 2013

commit 656cabe3de433012949be1e28419ad9034fc8ae4
Author: Per Buer <perbu at varnish-software.com>
Date:   Wed Oct 16 09:59:57 2013 +0200

    Expand on backslashes and quoting

diff --git a/doc/sphinx/users-guide/vcl-syntax.rst b/doc/sphinx/users-guide/vcl-syntax.rst
index 8277033..ce476b2 100644
--- a/doc/sphinx/users-guide/vcl-syntax.rst
+++ b/doc/sphinx/users-guide/vcl-syntax.rst
@@ -15,12 +15,21 @@ Strings
 Basic strings are enclosed in " ... ", and may not contain newlines.
+Backslash is not special, so for instance in regsub() you do not need
+to do the "count-the-backslashes" polka:::
+  regsub("barf", "(b)(a)(r)(f)", "\4\3\2p") -> "frap"
+Given that we have never been able to come up with a valid need for
+any escaped characters apart from that, we decided that %22 for " and
+%25 for %, was much less suffering than doubling all backslashes in
+regexp/regsub contexts.
 Long strings are enclosed in {" ... "}. They may contain any character
 including ", newline and other control characters except for the NUL
 (0x00) character. If you really want NUL characters in a string there
 is a VMOD that makes it possible to create such strings.
 Access control lists (ACLs)

More information about the varnish-commit mailing list