Document VM shutdown options

Signed-off-by: Justin Cinkelj <justin.cinkelj@xlab.si>

Author: justinc1

plugins/modules/vm.py

@@ -66,6 +66,13 @@
       - Desired VM state.
       - States C(PAUSE) and C(LIVEMIGRATE) are not exposed in this module
         (this can be done with raw api module).
+      - Note that:
+        - I(shutdown) will trigger a graceful ACPI shutdown.
+        - I(reboot) will trigger a graceful ACPI reboot.
+        - I(stop) will trigger an abrupt shutdown (force power off).
+          VM might loose data, and filesystem might be corrupted afterwards.
+        - I(reset) will trigger an abrupt reset (force power reset).
+          VM might loose data, and filesystem might be corrupted afterwards.
     choices: [ start, shutdown, stop, reboot, reset ]
     type: str
     default: start

plugins/modules/vm_params.py

@@ -51,7 +51,15 @@
   power_state:
     description:
       - Desired VM state.
-      - States C(PAUSE) and C(LIVEMIGRATE) are not exposed in this module (this can be done with raw api module).
+      - States C(PAUSE) and C(LIVEMIGRATE) are not exposed in this module
+        (this can be done with raw api module).
+      - Note that:
+        - I(shutdown) will trigger a graceful ACPI shutdown.
+        - I(reboot) will trigger a graceful ACPI reboot.
+        - I(stop) will trigger an abrupt shutdown (force power off).
+          VM might loose data, and filesystem might be corrupted afterwards.
+        - I(reset) will trigger an abrupt reset (force power reset).
+          VM might loose data, and filesystem might be corrupted afterwards.
     choices: [ start, shutdown, stop, reboot, reset ]
     type: str
   operating_system: