From c4a78d00f8d00ef4ab84c3110ffb6975ed680554 Mon Sep 17 00:00:00 2001 From: Andrea Bolognani Date: Tue, 11 Feb 2020 15:37:05 +0100 Subject: [PATCH] docs: Improve documentation for and MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Users expect to be able to configure the element and see that configuration reflected into the element or at least sticking, however due to our crazy back-compat code that doesn't always happen. There's really not much we can do to make this kind of corner cases work as the user would expect, especially not without introducing additional complexity in a part of libvirt that already has more than a fair share of it; we can, however, improve the documentation so that it will nudge said users in the right direction. https://bugzilla.redhat.com/show_bug.cgi?id=1770725 Signed-off-by: Andrea Bolognani Reviewed-by: Ján Tomko --- docs/formatdomain.html.in | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in index 44e2062d01..5ccf39abd1 100644 --- a/docs/formatdomain.html.in +++ b/docs/formatdomain.html.in @@ -7510,7 +7510,10 @@ qemu-kvm -net nic,model=? /dev/null since 4.7.0, 16550a (usable with the system-serial target type); sclpconsole and sclplmconsole (usable with - the sclp-serial target type). + the sclp-serial target type). Providing a target model is + usually unnecessary: libvirt will automatically pick one that's suitable + for the chosen target type, and overriding that value is generally not + recommended.

@@ -7656,7 +7659,8 @@ qemu-kvm -net nic,model=? /dev/null for early boot logging / interactive / recovery use, and one paravirtualized serial console to be used eg. as a side channel. Most people will be fine with having just the first console - element in their configuration. + element in their configuration, but if a specific configuration is + desired then both elements should be specified.