[master] b318692 Extend parts on heredoc in vcl.inline.
Lasse Karstensen
lkarsten at varnish-software.com
Thu Apr 14 09:06:04 CEST 2016
commit b3186921c80c6ed9423f7bdd394328e450dd8d3b
Author: Lasse Karstensen <lkarsten at varnish-software.com>
Date: Thu Apr 14 08:52:03 2016 +0200
Extend parts on heredoc in vcl.inline.
diff --git a/doc/sphinx/reference/varnish-cli.rst b/doc/sphinx/reference/varnish-cli.rst
index 17e86de..fa2fc76 100644
--- a/doc/sphinx/reference/varnish-cli.rst
+++ b/doc/sphinx/reference/varnish-cli.rst
@@ -51,15 +51,18 @@ Syntax
------
Commands are usually terminated with a newline. Long command can be
-entered using sh style *here documents*. The format of here-documents
-is::
+entered using sh style *here documents* (colloquially heredocs).
+The format of here-documents is::
<< word
here document
word
+.. :ref:`heredoc`
+
*word* can be any continuous string chosen to make sure it doesn't
-appear naturally in the following *here document*.
+appear naturally in the following *here document*. Commonly "EOF"
+is used.
When using the here document style of input there are no restrictions
on length. When using newline-terminated commands maximum length is
@@ -105,7 +108,7 @@ vcl.load <configname> <filename> [auto|cold|warm]
Compile and load the VCL file under the name provided.
vcl.inline <configname> <quoted_VCLstring> [auto|cold|warm]
- Compile and load the VCL data under the name provided.
+ Compile and load the VCL data under the name provided. Multi-line VCL can be input using :ref:`heredoc`.
vcl.use <configname>
Switch to the named configuration immediately.
More information about the varnish-commit
mailing list