docstring: Fix generated documentation of virStorageVolInfoFlags

The API xml description file generator doesn't properly handle cases
when there's either a single comment or mixed use of pre- and post-
comments explaining the values.

Modify the comments to avoid the problem and also append version
information for the exposed values.

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

diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-storage.h
index b7a7a6c90c697a53388e878c2c58d0ba80ff8055..dee8b7a2c0c8306500887f095e8f26f031dbd926 100644 (file)
--- a/include/libvirt/libvirt-storage.h
+++ b/include/libvirt/libvirt-storage.h
@@ -240,11 +240,8 @@ typedef enum {
  *
  */
 typedef enum {
-    VIR_STORAGE_VOL_USE_ALLOCATION = 0,
-
-    /* Return the physical size in allocation */
-    VIR_STORAGE_VOL_GET_PHYSICAL = 1 << 0,
-
+    VIR_STORAGE_VOL_USE_ALLOCATION = 0, /* (Since: v3.0.0) */
+    VIR_STORAGE_VOL_GET_PHYSICAL = 1 << 0, /* Return the physical size in allocation (Since: v3.0.0) */
 } virStorageVolInfoFlags;
 
 /**