lib: document fields virConnectDomainEventDiskChangeReason

diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-domain.h
index 9936cb2bb6cd91a130e8f9adb8590a9d4cc5bc44..160f20faa56e2d0ea0d217669613b3e1c4350f1e 100644 (file)
--- a/include/libvirt/libvirt-domain.h
+++ b/include/libvirt/libvirt-domain.h
@@ -3228,8 +3228,12 @@ typedef void (*virConnectDomainEventBlockJobCallback)(virConnectPtr conn,
  * The reason describing why this callback is called
  */
 typedef enum {
-    VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START = 0, /* oldSrcPath is set */
+    VIR_DOMAIN_EVENT_DISK_CHANGE_MISSING_ON_START = 0,
+    /* removable media changed to empty according to startup policy as source
+     * was missing. oldSrcPath is set, newSrcPath is NULL */
     VIR_DOMAIN_EVENT_DISK_DROP_MISSING_ON_START = 1,
+    /* disk was dropped from domain as source file was missing.
+     * oldSrcPath is set, newSrcPath is NULL */
 
 # ifdef VIR_ENUM_SENTINELS
     VIR_DOMAIN_EVENT_DISK_CHANGE_LAST