[PATCH v3 11/30] docstring: typedef: qemu:: Add 'Since version' metadata

Victor Toso victortoso at redhat.com
Wed Apr 20 19:08:00 UTC 2022


Either create or append to existing docstring, the version (git tag)
that a given typedef was introduced in the format:

    Since: v1.2.3

Signed-off-by: Victor Toso <victortoso at redhat.com>
---
 include/libvirt/libvirt-qemu.h | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/include/libvirt/libvirt-qemu.h b/include/libvirt/libvirt-qemu.h
index a2569a9fbd..9697b54158 100644
--- a/include/libvirt/libvirt-qemu.h
+++ b/include/libvirt/libvirt-qemu.h
@@ -30,6 +30,12 @@
 extern "C" {
 # endif
 
+/**
+ * virDomainQemuMonitorCommandFlags:
+ *
+ * Since: v0.8.8
+ *
+ */
 typedef enum {
     VIR_DOMAIN_QEMU_MONITOR_COMMAND_DEFAULT = 0, /* (Since: v0.8.8) */
     VIR_DOMAIN_QEMU_MONITOR_COMMAND_HMP     = (1 << 0), /* cmd is in HMP (Since: v0.8.8) */
@@ -50,6 +56,12 @@ virDomainPtr virDomainQemuAttach(virConnectPtr domain,
                                  unsigned int pid_value,
                                  unsigned int flags);
 
+/**
+ * virDomainQemuAgentCommandTimeoutValues:
+ *
+ * Since: v0.10.0
+ *
+ */
 typedef enum {
     VIR_DOMAIN_QEMU_AGENT_COMMAND_MIN = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK, /* (Since: v0.10.0) */
     VIR_DOMAIN_QEMU_AGENT_COMMAND_BLOCK = VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK, /* (Since: v0.10.0) */
@@ -84,6 +96,12 @@ typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn,
                                                          void *opaque);
 
 
+/**
+ * virConnectDomainQemuMonitorEventRegisterFlags:
+ *
+ * Since: v1.2.3
+ *
+ */
 typedef enum {
     /* Event filter is a regex rather than a literal string (Since: v1.2.3) */
     VIR_CONNECT_DOMAIN_QEMU_MONITOR_EVENT_REGISTER_REGEX = (1 << 0),
-- 
2.35.1



More information about the libvir-list mailing list