From b318686d1a945cb2786dbeb5869e712ae7d85eb1 Mon Sep 17 00:00:00 2001 From: hanzhijian Date: Sun, 14 Jun 2026 06:04:30 +0800 Subject: [PATCH] Fix duplicate Doxygen \defgroup ids in croutine.h and queue.h Fix incorrect Doxygen \defgroup identifiers that reuse group ids already defined by other API functions: - croutine.h: \defgroup crSTART -> crEND for the crEND() macro doc - queue.h: \defgroup uxQueueMessagesWaiting -> uxQueueSpacesAvailable for the uxQueueSpacesAvailable() function doc - queue.h: \defgroup xQueueSendFromISR -> xQueueSendToBackFromISR for the xQueueSendToBackFromISR() macro doc - queue.h: \defgroup xQueueSendFromISR -> xQueueGenericSendFromISR for the xQueueGenericSendFromISR() function doc When building documentation with Doxygen, these duplicates cause warnings like: group X: ignoring title Y that does not match old title Z Signed-off-by: hanzhijian --- include/croutine.h | 2 +- include/queue.h | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/include/croutine.h b/include/croutine.h index a5e2e4462da..7ec24aa8b51 100644 --- a/include/croutine.h +++ b/include/croutine.h @@ -243,7 +243,7 @@ void vCoRoutineSchedule( void ); * crEND(); * } * @endcode - * \defgroup crSTART crSTART + * \defgroup crEND crEND * \ingroup Tasks */ diff --git a/include/queue.h b/include/queue.h index e3dbbefd2f5..184843ea07d 100644 --- a/include/queue.h +++ b/include/queue.h @@ -945,7 +945,7 @@ UBaseType_t uxQueueMessagesWaiting( const QueueHandle_t xQueue ) PRIVILEGED_FUNC * * @return The number of spaces available in the queue. * - * \defgroup uxQueueMessagesWaiting uxQueueMessagesWaiting + * \defgroup uxQueueSpacesAvailable uxQueueSpacesAvailable * \ingroup QueueManagement */ UBaseType_t uxQueueSpacesAvailable( const QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; @@ -1111,7 +1111,7 @@ void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; * } * @endcode * - * \defgroup xQueueSendFromISR xQueueSendFromISR + * \defgroup xQueueSendToBackFromISR xQueueSendToBackFromISR * \ingroup QueueManagement */ #define xQueueSendToBackFromISR( xQueue, pvItemToQueue, pxHigherPriorityTaskWoken ) \ @@ -1363,7 +1363,7 @@ void vQueueDelete( QueueHandle_t xQueue ) PRIVILEGED_FUNCTION; * } * @endcode * - * \defgroup xQueueSendFromISR xQueueSendFromISR + * \defgroup xQueueGenericSendFromISR xQueueGenericSendFromISR * \ingroup QueueManagement */ BaseType_t xQueueGenericSendFromISR( QueueHandle_t xQueue,