From: Timo Sirainen <timo.sirainen@open-xchange.com>
Date: Thu, 30 Oct 2025 11:29:51 +0000 (+0200)
Subject: lib: Clarify io_loop_stop_delayed() comment
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2285794cdbc9ea2499f2bb2500ca23414906ab41;p=thirdparty%2Fdovecot%2Fcore.git

lib: Clarify io_loop_stop_delayed() comment
---

diff --git a/src/lib/ioloop.h b/src/lib/ioloop.h
index 06a84492fa..9b0b61a6de 100644
--- a/src/lib/ioloop.h
+++ b/src/lib/ioloop.h
@@ -186,7 +186,8 @@ void io_loop_run(struct ioloop *ioloop);
 /* Stop the ioloop immediately. No further IO or timeout callbacks are called.
    Warning: This is not safe to be called in non-delayed signal handlers. */
 void io_loop_stop(struct ioloop *ioloop);
-/* Stop ioloop after finishing all the pending IOs and timeouts. */
+/* Stop ioloop after finishing the rest of the IOs and timeouts for this
+   ioloop run iteration. Usually this isn't necessary or wanted. */
 void io_loop_stop_delayed(struct ioloop *ioloop);
 
 bool io_loop_is_running(struct ioloop *ioloop);