[libvirt] [PATCH] docs: improve documents for domxml-from-native and domxml-to-native commands

From: Alex Jia <ajia@redhat.com> * tools/virsh.pod: improve virsh man page for domxml-from-native and domxml-to-native commands. Signed-off-by: Alex Jia <ajia@redhat.com> --- tools/virsh.pod | 8 ++++++-- 1 files changed, 6 insertions(+), 2 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index dbe5165..ca0b993 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -670,12 +670,16 @@ seconds elapsed since the control interface entered its current state. =item B<domxml-from-native> I<format> I<config> Convert the file I<config> in the native guest configuration format -named by I<format> to a domain XML format. +named by I<format> to a domain XML format. For QEMU/KVM hypervisor, +the I<format> argument must be B<qemu-argv>. For Xen hypervisor, the +I<format> argument may be B<xen-xm> or B<xen-sxpr>. =item B<domxml-to-native> I<format> I<xml> Convert the file I<xml> in domain XML format to the native guest -configuration format named by I<format>. +configuration format named by I<format>. For QEMU/KVM hypervisor, +the I<format> argument must be B<qemu-argv>. For Xen hypervisor, the +I<format> argument may be B<xen-xm> or B<xen-sxpr>. =item B<dump> I<domain-id> I<corefilepath> [I<--bypass-cache>] { [I<--live>] | [I<--crash>] | [I<--reset>] } -- 1.7.1

On 12/20/2011 03:59 AM, ajia@redhat.com wrote:
From: Alex Jia <ajia@redhat.com>
Again a long subject line; shortened to: docs: improve virsh domxml-*-native command docs
* tools/virsh.pod: improve virsh man page for domxml-from-native and domxml-to-native commands.
Signed-off-by: Alex Jia <ajia@redhat.com> --- tools/virsh.pod | 8 ++++++-- 1 files changed, 6 insertions(+), 2 deletions(-)
Someday, I'd like an API that allows introspection; something like: int virConnectDomainXMLNativeFormats(virConnectPtr conn, char **names, int *nnames, unsigned int flags) where nnames of 0 queries the number of formats, and otherwise tells the size of *names on input and tells how many entries in *names were allocated on output. But until then, your fix is appropriate. ACK and pushed. -- Eric Blake eblake@redhat.com +1-919-301-3266 Libvirt virtualization library http://libvirt.org
participants (2)
-
ajia@redhat.com
-
Eric Blake