From a2fbbbd45e571f96c1e666211a6dcbd6d041cce0 Mon Sep 17 00:00:00 2001 From: Guillaume Souchere Date: Thu, 12 Jun 2025 08:23:20 +0200 Subject: [PATCH] change(esp-event): Update the doxygen comment of esp_event_handler_register Add a comment to specify what happens when registering a handler several times to the same event. --- components/esp_event/include/esp_event.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/components/esp_event/include/esp_event.h b/components/esp_event/include/esp_event.h index 8ec6365f90..ecd3d66b31 100644 --- a/components/esp_event/include/esp_event.h +++ b/components/esp_event/include/esp_event.h @@ -118,7 +118,9 @@ esp_err_t esp_event_loop_run(esp_event_loop_handle_t event_loop, TickType_t tick * * Registering multiple handlers to events is possible. Registering a single handler to multiple events is * also possible. However, registering the same handler to the same event multiple times would cause the - * previous registrations to be overwritten. + * overwriting of the event_handler_arg but the handler will be kept at the same position in the list associated + * with the event that triggers it. It means that the call order of registered handlers for that event will remain + * the same. * * @param[in] event_base the base ID of the event to register the handler for * @param[in] event_id the ID of the event to register the handler for