From: Collin Walling <walling@linux.ibm.com>
Date: Mon, 30 Jun 2025 03:19:26 +0000 (-0400)
Subject: docs: domain: document deprecated_features attribute
X-Git-Tag: v11.6.0-rc1~12
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e03995e63e66db013dbbb71f7577814458c1ceaa;p=thirdparty%2Flibvirt.git

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 56542b2b4b..976746e292 100644
--- 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.