[libvirt PATCH 2/2] include: Explicitly reserve values for overlapping flag types

[Andrea Bolognani]

Due to hystorical reasons, it needs to be possible to pass values
from the virTypedParameterFlags and virDomainModificationImpact
enumerations to a function at the same time, so it is very
important that the two never overlap.

Right now this is "enforced" by the presence of special comments;
unfortunately, said comments are not handled correctly by
apibuild.py and end up, quite confusingly, showing up as part of
the documentation for symbols preceding or following them.

Introduce actual entires in each enumeration for each of the
overlapping values, which is more explicit and results in
comments being parsed correctly.

Signed-off-by: Andrea Bolognani <abologna at redhat.com>
---
 include/libvirt/libvirt-common.h.in | 19 +++++++++++++++++--
 include/libvirt/libvirt-domain.h    |  8 ++++----
 2 files changed, 21 insertions(+), 6 deletions(-)

diff --git a/include/libvirt/libvirt-common.h.in b/include/libvirt/libvirt-common.h.in
index ccdbb2a100..2f20456dfd 100644
--- a/include/libvirt/libvirt-common.h.in
+++ b/include/libvirt/libvirt-common.h.in
@@ -159,8 +159,23 @@ typedef enum {
  * Since: 0.9.8
  */
 typedef enum {
-    /* 1 << 0 is reserved for virDomainModificationImpact */
-    /* 1 << 1 is reserved for virDomainModificationImpact */
+    /* Reserved for virDomainModificationImpact. Do not use.
+     *
+     * Since: 8.4.0
+     */
+    VIR_TYPED_PARAM_RESERVED1 = 0,
+
+    /* Reserved for virDomainModificationImpact. Do not use.
+     *
+     * Since: 8.4.0
+     */
+    VIR_TYPED_PARAM_RESERVED2 = 1 << 0,
+
+    /* Reserved for virDomainModificationImpact. Do not use.
+     *
+     * Since: 8.4.0
+     */
+    VIR_TYPED_PARAM_RESERVED3 = 1 << 1,
 
     /* Older servers lacked the ability to handle string typed
      * parameters.  Attempts to set a string parameter with an older
diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index 2edef9c4e1..94cb4a6615 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -321,10 +321,10 @@ typedef virDomainControlInfo *virDomainControlInfoPtr;
  * Since: 0.9.2
  */
 typedef enum {
-    VIR_DOMAIN_AFFECT_CURRENT = 0,      /* Affect current domain state. (Since: 0.9.2)  */
-    VIR_DOMAIN_AFFECT_LIVE    = 1 << 0, /* Affect running domain state. (Since: 0.9.2)  */
-    VIR_DOMAIN_AFFECT_CONFIG  = 1 << 1, /* Affect persistent domain state. (Since: 0.9.2) */
-    /* 1 << 2 is reserved for virTypedParameterFlags */
+    VIR_DOMAIN_AFFECT_CURRENT   = 0,      /* Affect current domain state. (Since: 0.9.2)  */
+    VIR_DOMAIN_AFFECT_LIVE      = 1 << 0, /* Affect running domain state. (Since: 0.9.2)  */
+    VIR_DOMAIN_AFFECT_CONFIG    = 1 << 1, /* Affect persistent domain state. (Since: 0.9.2) */
+    VIR_DOMAIN_AFFECT_RESERVED1 = 1 << 2, /* Reserved for virTypedParameterFlags. Do not use. (Since: 8.4.0) */
 } virDomainModificationImpact;
 
 /**
-- 
2.35.1