document vcl.list output change

Ref 45239c24

doc/changes.rst

@@ -67,6 +67,18 @@ Varnish Cache trunk (ongoing)
 * The undocumented ``-v`` option to the ``backend.list`` cli command
   has been removed
 
+* Changed the formatting of the ``vcl.list`` command from::
+
+    status	state/temperature	busy	name	[labelinfo]
+
+  to::
+
+    status	state	temperature	busy	name	[<-|->]	[info]
+
+  Column width is now dynamic.
+
+  See varnish-cli(7) for details on the field values (which remain unchanged).
+
 * The ban facility has been extended by bans access to obj.ttl,
   obj.age, obj.grace and obj.keep and additional inequality operators.
 

include/tbl/cli_cmds.h

@@ -107,7 +107,17 @@ CLI_CMD(VCL_LIST,
 	"vcl.list",
 	"vcl.list [-j]",
 	"List all loaded configuration.",
-	"  ``-j`` specifies JSON output.",
+	"  Unless ``-j`` is specified for JSON output, "
+	" the output format is five or seven columns of dynamic width, "
+	" separated by white space with the fields:\n\n"
+	"  * status: active, available or discarded\n\n"
+	"  * state: label, cold, warm, or auto\n\n"
+	"  * temperature: init, cold, warm, busy or cooling\n\n"
+	"  * busy: number of references to this vcl (integer)\n\n"
+	"  * name: the name given to this vcl or label\n\n"
+	"  * [ ``<-`` | ``->`` ] and label info last two fields)\n\n"
+	"    * ``->`` <vcl> : label \"points to\" the named <vcl>\n\n"
+	"    * ``<-`` (<n> label[s]): the vcl has <n> label(s)\n\n",
 	0, 0
 )