[libvirt] [PATCH] virsh: improve documentation

Matthias Bolte matthias.bolte at googlemail.com
Tue Apr 6 00:39:37 UTC 2010


2010/4/6 Eric Blake <eblake at redhat.com>:
> Document several missing commands.  There's more work that could be
> done, but incremental improvements is better than no patch at all.
>
> * tools/virsh.pod (autostart, connect): Improve grammar.
> (create): Improve example.
> (domjobabort, domjobinfo, domxml-from-native, domxml-to-native):
> Document.
> (storage pool commands): New section.
> ---
>  tools/virsh.pod |  167 ++++++++++++++++++++++++++++++++++++++++++++++++++----
>  1 files changed, 154 insertions(+), 13 deletions(-)
>

> @@ -260,11 +262,15 @@ Connect the virtual serial console for the guest.
>
>  =item B<create> I<FILE>
>
> -Create a domain from an XML <file>. An easy way to create the XML <file> is to use the B<dumpxml> command to obtain the definition of a pre-existing guest.
> +Create a domain from an XML <file>. An easy way to create the XML
> +<file> is to use the B<dumpxml> command to obtain the definition of a
> +pre-existing guest.
>
>  B<Example>
>
> -virsh dumpxml <domain-id> > file.
> +virsh dumpxml <domain-id> >

Redirecting to nothing? 'file' got lost.

> +edit file
> +virsh create < file

Maybe use domain.xml instead of file here to stay in sync with the
net-define example below.

> @@ -566,7 +591,7 @@ Edit the XML configuration file for a network.
>  This is equivalent to:
>  virsh net-dumpxml network > network.xml
>  edit network.xml
> - virsh define network.xml
> + virsh net-define network.xml
>  except that it does some error checking.
>

> +
> +=item B<pool-delete> I<pool-or-uuid>
> +
> +Destroy the resources used by a given I<pool> object. This operation
> +is non-recoverable.  The I<pool> object will still exist after this
> +command.
> +
> +=item B<pool-dumpxml> I<pool-or-uuid>
> +
> +Returns the XML information about the I<pool> object.
> +
> +=item B<pool-edit> I<pool-or-uuid>
> +
> +Edit the XML configuration file for a storage pool.
> +
> +This is equivalent to:
> + virsh pool-dumpxml pool > pool.xml
> + edit pool.xml
> + virsh pool-define pool.xml
> +except that it does some error checking.

Maybe add and empty line above and below the three indented commands.

ACK.

Matthias




More information about the libvir-list mailing list