Doc-fixino for vcl.label

Author: bsdphk

bin/varnishd/mgt/mgt_cli.c

@@ -690,14 +690,18 @@ void
 mgt_DumpRstCli(void)
 {
 	const struct cli_cmd_desc *cp;
+	const char *p;
 	int i, j;
 
 	qsort(cmds, ncmds, sizeof cmds[0], cli_cmp);
 	for (i = 0; i < ncmds; i++, cp++) {
 		cp = cmds[i];
 		if (!strncmp(cp->request, "debug.", 6))
 			continue;
-		printf(".. _ref_cli_%s:\n\n", cp->syntax);
+		printf(".. _ref_cli_");
+		for (p = cp->request; *p; p++)
+			putchar(*p == '.' ? '_' : *p);
+		printf(":\n\n");
 		printf("%s\n", cp->syntax);
 		for (j = 0; j < strlen(cp->syntax); j++)
 			printf("~");

doc/sphinx/users-guide/vcl-built-in-subs.rst

@@ -110,7 +110,7 @@ of the following keywords:
     Switch to vcl labelled *label*. This will continue vcl processing
     in this vcl's :ref:`vcl_recv` as if it was the active vcl.
 
-    See the :ref:`varnishadm(1)` ``vcl.label`` command.
+    See the :ref:`ref_cli_vcl_label` command.
 
 .. _vcl_pipe:
 
@@ -537,8 +537,8 @@ with one of the following keywords:
     :ref:`vcl_synth` on the client side is called with ``resp.status``
     preset to 503.
 
-vcl.load / vcl.discard
-----------------------
+During vcl.load / vcl.discard
+-----------------------------
 
 .. _vcl_init:
 

include/tbl/cli_cmds.h

@@ -141,7 +141,9 @@ CLI_CMD(VCL_LABEL,
 	"vcl.label",
 	"vcl.label <label> <configname>",
 	"Apply label to configuration.",
-	"",
+	"A VCL label is like a UNIX symbolic link, "
+	"a name without substance, which points to another VCL.\n\n"
+	"Labels are mandatory whenever one VCL references another.",
 	2, 2
 )