cli: Add xpath.* subargs to XML options

This adds the power of --xml to individual device options. For example
this makes it easier to make custom XML changes for a single --disk
device from both virt-install and virt-xml

Signed-off-by: Cole Robinson <crobinso@redhat.com>

1 files changed, 18 insertions, 0 deletions

diff --git a/man/virt-install.rst b/man/virt-install.rst
index b767afe1..6008adf7 100644
--- a/man/virt-install.rst
+++ b/man/virt-install.rst
@@ -258,6 +258,24 @@ The --xml option has 4 sub options:
 
 
 
+**xpath subarguments**
+``````````````````````
+
+Similar to the ``--xml`` option, most top level options have ``xpath.*``
+suboptions. For example, ``--disk xpath1.set=./@foo=bar,xpath2.create=./newelement``
+would generate XML alterations like
+
+.. code-block::
+
+       <disk foo="bar">
+         <newelements/>
+       </disk>
+
+This is useful for setting XML options per device, when virt-install does not
+support those options yet.
+
+
+
 ``--qemu-commandline``
 ^^^^^^^^^^^^^^^^^^^^^^