From: Peter Krempa <pkrempa@redhat.com>

If either of the autostart settings is enabled the VM will be
autostarted. Attempt to clarify that.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
---
 src/libvirt-domain.c | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
index f788fa9a58..738a0e9d85 100644
--- a/src/libvirt-domain.c
+++ b/src/libvirt-domain.c
@@ -7322,9 +7322,8 @@ virDomainCreateWithFiles(virDomainPtr domain, unsigned int nfiles,
  * @domain: a domain object
  * @autostart: the value returned
  *
- * Provides a boolean value indicating whether the domain
- * configured to be automatically started when the host
- * machine boots.
+ * Provides a boolean value indicating whether the domain is configured to be
+ * automatically started each time when the host machine boots.
  *
  * Returns -1 in case of error, 0 in case of success
  *
@@ -7366,8 +7365,8 @@ virDomainGetAutostart(virDomainPtr domain,
  * @domain: a domain object
  * @autostart: whether the domain should be automatically started 0 or 1
  *
- * Configure the domain to be automatically started
- * when the host machine boots.
+ * Configure the domain to be automatically started eacth time when the host
+ * machine boots.
  *
  * Returns -1 in case of error, 0 in case of success
  *
@@ -7409,9 +7408,12 @@ virDomainSetAutostart(virDomainPtr domain,
  * @domain: a domain object
  * @autostart: the value returned
  *
- * Provides a boolean value indicating whether the domain
- * is configured to be automatically started the next time
- * the host machine boots only.
+ * Provides a boolean value indicating whether the domain is configured to be
+ * automatically started next time when the host machine boots.
+ *
+ * Note that autostart configured via the virDomain[Set|Get]AutostartOnce APIs
+ * is independent from the autostart configured via virDomain[Set|Get]Autostart.
+ * Enabling either of them will cause the VM to be started on the next boot.
  *
  * Returns -1 in case of error, 0 in case of success
  *
@@ -7453,8 +7455,12 @@ virDomainGetAutostartOnce(virDomainPtr domain,
  * @domain: a domain object
  * @autostart: whether the domain should be automatically started 0 or 1
  *
- * Configure the domain to be automatically started
- * the next time the host machine boots only.
+ * Configure the domain to be automatically started eacth time when the host
+ * machine boots.
+ *
+ * Note that autostart configured via the virDomain[Set|Get]AutostartOnce APIs
+ * is independent from the autostart configured via virDomain[Set|Get]Autostart.
+ * Enabling either of them will cause the VM to be started on the next boot.
  *
  * Returns -1 in case of error, 0 in case of success
  *
-- 
2.49.0

On a Monday in 2025, Peter Krempa via Devel wrote:
>From: Peter Krempa <pkrempa@redhat.com>
>
>If either of the autostart settings is enabled the VM will be
>autostarted. Attempt to clarify that.
>
>Signed-off-by: Peter Krempa <pkrempa@redhat.com>
>---
> src/libvirt-domain.c | 26 ++++++++++++++++----------
> 1 file changed, 16 insertions(+), 10 deletions(-)
>
>diff --git a/src/libvirt-domain.c b/src/libvirt-domain.c
>index f788fa9a58..738a0e9d85 100644
>--- a/src/libvirt-domain.c
>+++ b/src/libvirt-domain.c
>@@ -7366,8 +7365,8 @@ virDomainGetAutostart(virDomainPtr domain,
>  * @domain: a domain object
>  * @autostart: whether the domain should be automatically started 0 or 1
>  *
>- * Configure the domain to be automatically started
>- * when the host machine boots.
>+ * Configure the domain to be automatically started eacth time when the host

*each

>+ * machine boots.
>  *
>  * Returns -1 in case of error, 0 in case of success
>  *
>@@ -7409,9 +7408,12 @@ virDomainSetAutostart(virDomainPtr domain,
>  * @domain: a domain object
>  * @autostart: the value returned
>  *
>- * Provides a boolean value indicating whether the domain
>- * is configured to be automatically started the next time
>- * the host machine boots only.
>+ * Provides a boolean value indicating whether the domain is configured to be
>+ * automatically started next time when the host machine boots.
>+ *
>+ * Note that autostart configured via the virDomain[Set|Get]AutostartOnce APIs
>+ * is independent from the autostart configured via virDomain[Set|Get]Autostart.
>+ * Enabling either of them will cause the VM to be started on the next boot.
>  *
>  * Returns -1 in case of error, 0 in case of success
>  *
>@@ -7453,8 +7455,12 @@ virDomainGetAutostartOnce(virDomainPtr domain,
>  * @domain: a domain object
>  * @autostart: whether the domain should be automatically started 0 or 1
>  *
>- * Configure the domain to be automatically started
>- * the next time the host machine boots only.
>+ * Configure the domain to be automatically started eacth time when the host
>+ * machine boots.
>+ *

*the next time

this is the comment virDomainSetAutostartOnce, if my eyes serve me well.

>+ * Note that autostart configured via the virDomain[Set|Get]AutostartOnce APIs
>+ * is independent from the autostart configured via virDomain[Set|Get]Autostart.
>+ * Enabling either of them will cause the VM to be started on the next boot.
>  *
>  * Returns -1 in case of error, 0 in case of success
>  *

Reviewed-by: Ján Tomko <jtomko@redhat.com>

Jano