[master] 7239fe3 Document how comments work in VCL.

[Lasse Karstensen]

commit 7239fe3eaa309a5b3742b92ebadaf9d13944f31c
Author: Lasse Karstensen <lkarsten at varnish-software.com>
Date:   Wed Oct 8 17:21:27 2014 +0200

    Document how comments work in VCL.
    
    This was mentioned in the user guide, but not in the man
    page itself.
    
    Pointed out by:		Brett Fitzgerald

diff --git a/doc/sphinx/reference/vcl.rst b/doc/sphinx/reference/vcl.rst
index 90ac019..a621e4f 100644
--- a/doc/sphinx/reference/vcl.rst
+++ b/doc/sphinx/reference/vcl.rst
@@ -166,6 +166,21 @@ Example::
         std.log("foo");
     }
 
+Comments
+--------
+
+Single lines of VCL can be commented out using // or #. Multi-line blocks can
+be commented out with \/\* block \/\*.
+
+Example::
+
+    sub vcl_recv {
+        // Single line of out-commented VCL.
+        # Another way of commenting out a single line.
+        /*
+            Multi-line block of commented-out VCL.
+        */
+    }
 
 
 Backend definition