From bb0e0bcf6a0d785df7063cb6118b3a25f2a24d55 Mon Sep 17 00:00:00 2001
From: Kashyap Chamarthy <kchamart@redhat.com>
Date: Mon, 26 Mar 2018 12:53:12 +0200
Subject: [PATCH] docs: formatdomain: Clarify CPU feature policy option
 "require"

Using the 'require' value for the 'policy' attribute indicates
that the guest will have the feature so the host CPU does not
need to support it if the hypervisor can emulate it.

E.g. 'x2apic' is emulated by QEMU even if the host does not support it:

    <feature policy='require' name='x2apic'/>

Signed-off-by: Kashyap Chamarthy <kchamart@redhat.com>
---
 docs/formatdomain.html.in | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index 08dc74b6b9..82e7d7ce66 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1531,8 +1531,8 @@
           <dd>The virtual CPU will claim the feature is supported regardless
             of it being supported by host CPU.</dd>
           <dt><code>require</code></dt>
-          <dd>Guest creation will fail unless the feature is supported by host
-            CPU.</dd>
+          <dd>Guest creation will fail unless the feature is supported by the
+            host CPU or the hypervisor is able to emulate it.</dd>
           <dt><code>optional</code></dt>
           <dd>The feature will be supported by virtual CPU if and only if it
             is supported by host CPU.</dd>
-- 
GitLab