[libvirt] [PATCH 1/2] virsh: man: Be more explicit about 'create' creating transient domain

[Martin Kletzander]

On Thu, Sep 07, 2017 at 03:48:13PM +0200, Erik Skultety wrote:
>So we refer to terms 'persistent' and 'transient' across the whole man
>page, without explicitly stating that domain created via the 'create'
>command is in fact transient and will vanish once destroyed.
>
>Signed-off-by: Erik Skultety <eskultet at redhat.com>
>---
> tools/virsh.pod | 5 +++++
> 1 file changed, 5 insertions(+)
>
>diff --git a/tools/virsh.pod b/tools/virsh.pod
>index c13f96f22..14a01e9ba 100644
>--- a/tools/virsh.pod
>+++ b/tools/virsh.pod
>@@ -652,6 +652,11 @@ of open file descriptors which should be pass on into the guest. The
> file descriptors will be re-numbered in the guest, starting from 3. This
> is only supported with container based virtualization.
>
>+Note that a domain created using this command is transient (temporary), meaning
>+that such a domain simply disappears once shut off or destroyed and any
>+subsequent attempts to B<start> it will fail. See B<define> command on how to
>+make a domain persistent.
>+

Not really.  With this command you can also start existing domain, just
with a different configuration.  Given that the example below shows
exactly that usage, I think someone might get a bit confused.  Would you
mind rewriting it to accommodate all variants?

> B<Example>
>
>  virsh dumpxml <domain> > domain.xml
>--
>2.13.3
>
>--
>libvir-list mailing list
>libvir-list at redhat.com
>https://www.redhat.com/mailman/listinfo/libvir-list
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: Digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20170908/c27c0025/attachment-0001.sig>