Doxygen errors galor

Kernel
1

I’m trying to build FreeRTOS documentation with Doxygen version 1.17.0.
Lots of errors are generated about missing groups (examples below), and much of the documentation in the header files is not output by doxygen. So:

  • I don’t see a FreeRTOS.doxyfile in the distribution?
  • Is this documentation not actively maintained?
  • Or more likely, what am I missing?

Thanks!
Best Regards, Dave

FreeRTOS-Kernel-11.3.0/include/task.h:1067: warning: group uxTaskPriorityGet: ignoring title "uxTaskBasePriorityGet" that does not match old title "uxTaskPriorityGet"
FreeRTOS-Kernel-11.3.0/include/event_groups.h:99: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:168: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:325: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:389: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:452: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:529: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:604: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:737: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:762: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/event_groups.h:782: warning: Found non-existing group 'EventGroup' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:157: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:242: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:279: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:384: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:492: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:584: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:689: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:785: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:818: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:843: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:868: warning: Found non-existing group 'MessageBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:911: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/message_buffer.h:955: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:145: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:231: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:260: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:342: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:425: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:510: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:594: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:683: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:781: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:817: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:910: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:929: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:948: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:964: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:1038: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:1114: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:1205: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:1283: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:1366: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/queue.h:1464: warning: Found non-existing group 'QueueManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:93: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:163: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:224: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:295: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:390: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:457: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:543: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:637: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:731: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:794: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:864: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:939: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:1021: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:1108: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/semphr.h:1126: warning: Found non-existing group 'Semaphores' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:162: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:262: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:348: warning: Found non-existing group 'StreamBatchingBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:450: warning: Found non-existing group 'StreamBatchingBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:488: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:589: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:693: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:785: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:874: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:902: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:925: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:948: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:978: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1010: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1034: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1058: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1098: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1141: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1185: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1212: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
FreeRTOS-Kernel-11.3.0/include/stream_buffer.h:1242: warning: Found non-existing group 'StreamBufferManagement' for the command '@ingroup', ignoring command
2

The website documentation is generated (to my knowledge) with Doxygen (or a related package), so I suspect is actively maintained, but isn’t designed for external use, which is why a doxyfile isn’t provided, and some of the definitions seem to be outside the normal source tree.

3

Thanks @richard-damon - It would be great if the distribution could include a working doxyfile. This would allow us to ensure our documentation was OK for a pull-request, and to build documentation for our own versions (including modifications not accepted as pull-requests, like my updates for ISR/MSP stack monitoring).
Thanks again!
Best Regards, Dave