From 6ab6d3f0740746e72b9271f8d186eeca0fa60195 Mon Sep 17 00:00:00 2001
From: Peter Krempa <pkrempa@redhat.com>
Date: Thu, 19 Aug 2021 14:54:18 +0200
Subject: [PATCH] qemuDomainObjPrivate: Annotate 'allowReboot' field

Save further readers the headache of determining what it actually does
and note that it's not used with qemu version supporting the
'set-action' command.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
---
 src/qemu/qemu_domain.h | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/qemu/qemu_domain.h b/src/qemu/qemu_domain.h
index abc3c7158d..f3c6bb3390 100644
--- a/src/qemu/qemu_domain.h
+++ b/src/qemu/qemu_domain.h
@@ -154,6 +154,14 @@ struct _qemuDomainObjPrivate {
 
     bool fakeReboot;
     bool pausedShutdown;
+    /* allowReboot:
+     *
+     * Unused with new QEMU versions which have QEMU_CAPS_SET_ACTION.
+     *
+     * Otherwise if it's set to VIR_TRISTATE_BOOL_YES, QEMU was started with
+     * -no-shutdown, and if set to VIR_TRISTATE_BOOL_NO qemu was started with
+     * -no-reboot instead.
+     */
     virTristateBool allowReboot;
 
     int jobs_queued;