[PATCH 02/11] docs: drvqemu: Decrease expectations about command line from 'virsh domxml-to-native'

[Peter Krempa]

In the qemu driver certain configs such as disk throttling or CPU
hotplug is configured by interacting with the monitor at the startup
phase of the hypervisor and thus is not part of the "native config".

Add a paragraph into the documentation outlining that the native
configuration might not be completely usable.

Signed-off-by: Peter Krempa <pkrempa at redhat.com>
---
 docs/drvqemu.rst | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/docs/drvqemu.rst b/docs/drvqemu.rst
index 6368a91fb9..e08a60c705 100644
--- a/docs/drvqemu.rst
+++ b/docs/drvqemu.rst
@@ -443,10 +443,16 @@ Converting from domain XML to QEMU args
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 The ``virsh domxml-to-native`` provides a way to convert a guest description
-using libvirt Domain XML, into a set of QEMU args that can be run manually. Note
-that currently the command line formatted by libvirt is no longer suited for
-manually running qemu as the configuration expects various resources and open
-file descriptors passed to the process which are usually prepared by libvirtd.
+using libvirt Domain XML, into a set of QEMU args that would be used by libvirt
+to start the qemu process.
+
+Note that currently the command line formatted by libvirt is no longer suited
+for manually running qemu as the configuration expects various resources and
+open file descriptors passed to the process which are usually prepared by
+libvirtd as well as certain features being configured via the monitor.
+
+The qemu arguments as returned by ``virsh domxml-to-native`` thus are not
+trivially usable outside of libvirt.

 Pass-through of arbitrary qemu commands
 ---------------------------------------
-- 
2.35.3