[master] 624350a0e cli: Rewrite the vcl.discard documentation

Nils Goroll nils.goroll at uplex.de
Tue Jan 12 15:34:07 UTC 2021

commit 624350a0e83f302b5ebb2a67b43a87a06fdbe40b
Author: Dridi Boukelmoune <dridi.boukelmoune at gmail.com>
Date:   Tue Jan 12 15:58:00 2021 +0100

    cli: Rewrite the vcl.discard documentation
    Trying to be more descriptive about glob patterns, inspired by the
    backend.list documentation.

diff --git a/include/tbl/cli_cmds.h b/include/tbl/cli_cmds.h
index 7249f8dd7..9537833f6 100644
--- a/include/tbl/cli_cmds.h
+++ b/include/tbl/cli_cmds.h
@@ -99,13 +99,16 @@ CLI_CMD(VCL_STATE,
-	"vcl.discard <configname|label>...",
-	"Unload the named configurations (if possible).",
-	"The configname or label arguments are matched as glob patterns."
-	" If more than one configuration matches patterns the command"
-	" is equivalent to individual commands in the right order with"
-	" respect to configurations dependencies."
-	" All individual patterns must match at least one configuration.",
+	"vcl.discard <name_pattern>...",
+	"Unload the named configurations (when possible).",
+	"Unload the named configurations and labels matching at least"
+	" one name pattern. All matching configurations and labels"
+	" are discarded in the correct order with respect to potential"
+	" dependencies. If one configuration or label could not be"
+	" discarded because one of its dependencies would remain,"
+	" nothing is discarded."
+	" Each individual name pattern must match at least one named"
+	" configuration or label.",
 	1, -1

More information about the varnish-commit mailing list