2010/4/6 Eric Blake <eblake@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