doxygen: improve howto

- Add description on how to group macros.
- Add description for structs on how to write comments
  for members when the name of member is too.
- Use @ref to link group instead of the html filenames.

Signed-off-by: Chen Wang <unicorn_wang@outlook.com>
This commit is contained in:
Chen Wang
2025-03-06 15:52:37 +08:00
committed by Rbb666
parent b506228893
commit 94afe6a4f1
7 changed files with 82 additions and 32 deletions

View File

@@ -16,9 +16,7 @@
* <a href="https://github.com/RT-Thread/rt-thread/blob/master/documentation/0.doxygen/example/include/enum.h">documentation/0.doxygen/example/include/enum.h</a>
* for code example.
*
* See
* <a href="./group__group__doxygen__example__enum.html">Doxygen Example of Enumeration</a>
* for html output.
* See @ref group_doxygen_example_enum for html output.
*/
/**