[PATCH v2 18/34] docs: manual: macros: add docstring and Since metadata

Victor Toso victortoso at redhat.com
Thu Apr 14 20:47:29 UTC 2022


This commit finishes the script work and adds docstring to types that
are not documented.

>From this commit onwards, all exported macros are versioned.
Further commits will enforce that it stays like that with new
additions.

Signed-off-by: Victor Toso <victortoso at redhat.com>
---
 include/libvirt/libvirt-domain.h | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index 9163c9dcab..20a476412f 100644
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -6244,6 +6244,14 @@ typedef enum {
  */
 # define VIR_DOMAIN_SCHED_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
 
+/**
+ * _virSchedParameter:
+ *
+ * Since: v0.9.2
+ *
+ */
+# define _virSchedParameter _virTypedParameter
+
 /**
  * virSchedParameter:
  *
@@ -6254,7 +6262,6 @@ typedef enum {
  * Since: v0.9.2
  *
  */
-# define _virSchedParameter _virTypedParameter
 typedef struct _virTypedParameter virSchedParameter;
 
 /**
@@ -6299,6 +6306,14 @@ typedef enum {
  */
 # define VIR_DOMAIN_BLKIO_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
 
+/**
+ * _virBlkioParameter:
+ *
+ * Since: v0.9.2
+ *
+ */
+# define _virBlkioParameter _virTypedParameter
+
 /**
  * virBlkioParameter:
  *
@@ -6309,7 +6324,6 @@ typedef enum {
  * Since: v0.9.2
  *
  */
-# define _virBlkioParameter _virTypedParameter
 typedef struct _virTypedParameter virBlkioParameter;
 
 /**
@@ -6354,6 +6368,14 @@ typedef enum {
  */
 # define VIR_DOMAIN_MEMORY_FIELD_LENGTH VIR_TYPED_PARAM_FIELD_LENGTH
 
+/**
+ * _virMemoryParameter:
+ *
+ * Since: v0.9.2
+ *
+ */
+# define _virMemoryParameter _virTypedParameter
+
 /**
  * virMemoryParameter:
  *
@@ -6364,7 +6386,6 @@ typedef enum {
  * Since: v0.9.2
  *
  */
-# define _virMemoryParameter _virTypedParameter
 typedef struct _virTypedParameter virMemoryParameter;
 
 /**
-- 
2.35.1



More information about the libvir-list mailing list