[master] 125946c improve documentation for ban.list

[Nils Goroll]

commit 125946c2311f1ed021e7574de474ee430e3d478e
Author: Nils Goroll <nils.goroll at uplex.de>
Date:   Wed Feb 10 14:31:01 2016 +0100

    improve documentation for ban.list

diff --git a/doc/sphinx/reference/varnish-cli.rst b/doc/sphinx/reference/varnish-cli.rst
index 55a2528..7dcc9a4 100644
--- a/doc/sphinx/reference/varnish-cli.rst
+++ b/doc/sphinx/reference/varnish-cli.rst
@@ -149,7 +149,23 @@ ban <field> <operator> <arg> [&& <field> <oper> <arg> ...]
   Mark obsolete all objects where all the conditions match.
 
 ban.list
-  List the active bans.
+  List the active bans. The output format is:
+
+  * time the ban was issued
+
+  * reference count
+
+  * ``C`` for completed bans (replaced by a newer ban) or ``-``
+
+  * if ``lurker`` debugging is enabled
+
+    * ``R`` for bans on request properties or ``-``
+
+    * ``O`` for bans on object properties or ``-``
+
+    * pointer to the ban object
+
+  * ban specification
 
 Backend Expression
 ------------------