docs: domain: document deprecated_features attribute

Provide documentation for the deprecated_features XML attribute.
Available since 11.0.0, and supported for S390.

Signed-off-by: Collin Walling <walling@linux.ibm.com>
Reviewed-by: Boris Fiuczynski <fiuczy@linux.ibm.com>
Acked-by: Thomas Huth <thuth@redhat.com>

diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst
index 56542b2b4b002ecdd4538412aef34659a7c7ea81..976746e29256b02723cb2178f085289e55c57197 100644 (file)
--- a/docs/formatdomain.rst
+++ b/docs/formatdomain.rst
@@ -1674,6 +1674,14 @@ In case no restrictions need to be put on CPU model and its features, a simpler
       </cpu>
       ...
 
+``deprecated_features``
+   :since:`Since 11.0.0`, S390 guests may utilize the ``deprecated_features``
+   attribute to specify toggling of CPU model features that are flagged as
+   deprecated by the hypervisor. When this attribute is set to ``off``, the
+   active guest XML will reflect the respective features with the disable
+   policy. When this attribute is set to ``on``, the respective features will
+   be enabled.
+
 ``cache``
    :since:`Since 3.3.0` the ``cache`` element describes the virtual CPU cache.
    If the element is missing, the hypervisor will use a sensible default.