[libvirt] [PATCH] virsh: Fix and clarify the --title flag for the list command in man page

--- tools/virsh.pod | 9 +++++---- 1 files changed, 5 insertions(+), 4 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 140d8e8..25751b6 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -398,13 +398,14 @@ 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 -I<--table> output. +If I<--title> is specified, then the short domain description - title - is +printed. 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 -- 1.7.3.4

On 04/19/2012 11:03 AM, Peter Krempa wrote:
--- tools/virsh.pod | 9 +++++---- 1 files changed, 5 insertions(+), 4 deletions(-) Effect of this patch on the manpage:
Before: If --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 --table output. virsh list --title Id Name State Title ----------------------------------------------- 0 Domain-0 running Mailserver 1 2 fedora paused After: If --title is specified, then the short domain description - title - is printed. This flag is usable only with the default --table output. Example: virsh list --title Id Name State Title ----------------------------------------------- 0 Domain-0 running Mailserver 1 2 fedora paused

On 2012年04月19日 17:03, Peter Krempa wrote:
--- tools/virsh.pod | 9 +++++---- 1 files changed, 5 insertions(+), 4 deletions(-)
diff --git a/tools/virsh.pod b/tools/virsh.pod index 140d8e8..25751b6 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -398,13 +398,14 @@ 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 -I<--table> output. +If I<--title> is specified, then the short domain description - title - is +printed. 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
ACK. But how about "short domain description (title)"? Osier

On 04/19/2012 12:01 PM, Osier Yang wrote:
On 2012年04月19日 17:03, Peter Krempa wrote:
--- tools/virsh.pod | 9 +++++---- 1 files changed, 5 insertions(+), 4 deletions(-)
ACK. But how about "short domain description (title)"?
That looks better! I changed the hyphens to brackets, added a short note that the title is printed in a new column of the output and pushed Thanks. Peter
Osier
participants (2)
-
Osier Yang
-
Peter Krempa