lib: Clarify io_loop_stop_delayed() comment

diff --git a/src/lib/ioloop.h b/src/lib/ioloop.h
index 06a84492fa9cefac224c3a9808f4786b70614d2b..9b0b61a6ded0161843c3b51e50cab594c049b916 100644 (file)
--- 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);