[libvirt] [PATCH 1/3] docs: snapshot: Encourage people ot use disk 'target' to refer to disks

[Peter Krempa]

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

Signed-off-by: Peter Krempa <pkrempa at redhat.com>
---
 docs/formatsnapshot.html.in | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

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