Associate II
April 3, 2020
Question
Generated files have numerous Doxygen warnings
- April 3, 2020
- 1 reply
- 1662 views
STM32CubeIDE — brand new project with HAL, no user code yet.
Generated code includes `@param None` and `@result None` — so Dox is looking for a parameter in the function named `None` — and that in turn is generating an error which is rendered in Eclipse (when using the doxygen plugin).
The authors of the generated code have done this in many, many places which is littering the IDE text editor with dozens of warnings.
These need to be removed. If there's no paramters, do not include @param. If there is not return value, do not include @return. If there's a need to state these things explicitly (I don't think there is), it should be written in the @brief — perhaps as "No params. No return value."