virsh: Fix and clarify the --title flag for the list command in man page

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 140d8e82cadf40d7f56f1d9776c26b6d83c8e072..ca5c853838b52347c25b6c2cb49fce48a4af0a53 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -398,13 +398,15 @@ may be combined. Default behavior is as though both were specified. (Note that
 if any of these flags is specified, the check for the persistence state is done
 and may fail. If none of these flags is specified, the check is skipped.)
 
-If I<--title> is specified, then the domain note is printed. The output then
-the output looks as follows. This flag is usable only with the default
+If I<--title> is specified, then the short domain description (title) is
+printed in an extra column. This flag is usable only with the default
 I<--table> output.
 
+Example:
+
 B<virsh> list --title
  Id Name                 State      Title
------------------------------------------------
+ -----------------------------------------------
   0 Domain-0             running    Mailserver 1
   2 fedora               paused