docs: snapshot: Encourage people ot use disk 'target' to refer to disks

Change the example and add a recommendation to use disk target rather
than path.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Martin Kletzander <mkletzan@redhat.com>
This commit is contained in:
Peter Krempa 2019-06-20 09:57:54 +02:00
parent 05ac854cc8
commit c79ef73c37

View File

@ -140,8 +140,8 @@
<dd>This sub-element describes the snapshot properties of a <dd>This sub-element describes the snapshot properties of a
specific disk. The attribute <code>name</code> is specific disk. The attribute <code>name</code> is
mandatory, and must match either the <code>&lt;target mandatory, and must match either the <code>&lt;target
dev='name'/&gt;</code> or an unambiguous <code>&lt;source dev='name'/&gt;</code> (recommended) or an unambiguous
file='name'/&gt;</code> of one of <code>&lt;source file='name'/&gt;</code> of one of
the <a href="formatdomain.html#elementsDisks">disk the <a href="formatdomain.html#elementsDisks">disk
devices</a> specified for the domain at the time of the devices</a> specified for the domain at the time of the
snapshot. The attribute <code>snapshot</code> is snapshot. The attribute <code>snapshot</code> is
@ -255,7 +255,7 @@
&lt;domainsnapshot&gt; &lt;domainsnapshot&gt;
&lt;description&gt;Snapshot of OS install and updates&lt;/description&gt; &lt;description&gt;Snapshot of OS install and updates&lt;/description&gt;
&lt;disks&gt; &lt;disks&gt;
&lt;disk name='/path/to/old'&gt; &lt;disk name='vda'&gt;
&lt;source file='/path/to/new'/&gt; &lt;source file='/path/to/new'/&gt;
&lt;/disk&gt; &lt;/disk&gt;
&lt;disk name='vdb' snapshot='no'/&gt; &lt;disk name='vdb' snapshot='no'/&gt;