#3708 assigned task

Remove Doxygen comments from confdefs.h

Reported by: Sebastian Huber Owned by: Sebastian Huber
Priority: normal Milestone: 6.1
Component: doc Version: 6
Severity: normal Keywords: qualification
Cc: Blocked By:
Blocking: #3705

Description

The confdefs.h file contains Doxygen comments. They are not helpful and lead to a confusing Doxygen output. The documentation place for the RTEMS configuration is the RTEMS Classic API Guide:

https://docs.rtems.org/branches/master/c-user/configuring_a_system.html

Change History (3)

comment:1 Changed on Feb 27, 2019 at 11:48:33 PM by Chris Johns

Can a link be added so doxygen generate docs point to the documentation?

comment:2 Changed on Feb 27, 2019 at 11:52:08 PM by Joel Sherrill

I am against a patch that removes them without verifying that all info in the Doxygen comments is already in the Classic API Guide. There has to be at least some information in confdefs.h comments that isn't in the manual.

comment:3 Changed on Feb 28, 2019 at 2:18:19 PM by Sebastian Huber

I think we all agreed that the user documentation is in the manuals and Doxygen is for internal use, e.g. for RTEMS contributors.

If something is in Doxygen comments in confdefs.h which is not in the manual, then of course we should update the manual.

Note: See TracTickets for help on using tickets.