docstring: function: qemu: Add 'Since version' metadata

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

    Since: v1.2.3

Signed-off-by: Victor Toso <victortoso@redhat.com>
Reviewed-by: Peter Krempa <pkrempa@redhat.com>

diff --git a/include/libvirt/libvirt-qemu.h b/include/libvirt/libvirt-qemu.h
index dc176d84e482c5aa329bb73e653e52e6348b73ec..7aff5a1c9637cb85a1ec2101374e7b3ac6238b17 100644 (file)
--- a/include/libvirt/libvirt-qemu.h
+++ b/include/libvirt/libvirt-qemu.h
@@ -84,6 +84,8 @@ char *virDomainQemuAgentCommand(virDomainPtr domain, const char *cmd,
  *
  * The callback signature to use when registering for a qemu monitor
  * event with virConnectDomainQemuMonitorEventRegister().
+ *
+ * Since: v1.2.3
  */
 typedef void (*virConnectDomainQemuMonitorEventCallback)(virConnectPtr conn,
                                                          virDomainPtr dom,

diff --git a/src/libvirt-qemu.c b/src/libvirt-qemu.c
index 896aba2f0b105a5a20a9d6dae839d83f7fe0cfa8..d4ddbed0599cdf1cff9303699735a8845a4e0b79 100644 (file)
--- a/src/libvirt-qemu.c
+++ b/src/libvirt-qemu.c
@@ -61,6 +61,7 @@ VIR_LOG_INIT("libvirt-qemu");
  *
  * Returns 0 in case of success, -1 in case of failure
  *
+ * Since: v0.8.3
  */
 int
 virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd,
@@ -131,6 +132,8 @@ virDomainQemuMonitorCommand(virDomainPtr domain, const char *cmd,
  * @cmd, and the caller must free this string.
  *
  * Returns 0 in case of success, -1 in case of failure
+ *
+ * Since: v8.2.0
  */
 int
 virDomainQemuMonitorCommandWithFiles(virDomainPtr domain,
@@ -216,6 +219,8 @@ virDomainQemuMonitorCommandWithFiles(virDomainPtr domain,
  * normally (provided the above requirements were honored).
  *
  * Returns a new domain object on success, NULL otherwise
+ *
+ * Since: v0.9.4
  */
 virDomainPtr
 virDomainQemuAttach(virConnectPtr conn,
@@ -272,6 +277,8 @@ virDomainQemuAttach(virConnectPtr conn,
  * positive value: wait for @timeout seconds
  *
  * Returns strings if success, NULL in failure.
+ *
+ * Since: v0.10.0
  */
 char *
 virDomainQemuAgentCommand(virDomainPtr domain,
@@ -350,6 +357,8 @@ virDomainQemuAgentCommand(virDomainPtr domain,
  * be passed to the virConnectDomainQemuMonitorEventDeregister() method.
  *
  * Returns a callback identifier on success, -1 on failure
+ *
+ * Since: v1.2.3
  */
 int
 virConnectDomainQemuMonitorEventRegister(virConnectPtr conn,
@@ -404,6 +413,8 @@ virConnectDomainQemuMonitorEventRegister(virConnectPtr conn,
  * method.
  *
  * Returns 0 on success, -1 on failure
+ *
+ * Since: v1.2.3
  */
 int
 virConnectDomainQemuMonitorEventDeregister(virConnectPtr conn,