mirror of
https://github.com/RT-Thread/rt-thread.git
synced 2025-02-24 23:07:11 +08:00
761bb89f27
Documentation is provided to clarify how to write doxygen documentation for RT-Thread. This document is also integrated as part of RT-Thread doxygen documentation. An example is also provided. The original README.md is removed and integrated into this document. Updated github actions for doxygen too. Signed-off-by: Chen Wang <unicorn_wang@outlook.com>
38 lines
935 B
C
38 lines
935 B
C
#ifndef _DOXYGEN_EXAMPLE_UNION_H_
|
|
#define _DOXYGEN_EXAMPLE_UNION_H_
|
|
|
|
/**
|
|
* @page page_howto_union How to write doxygen documentation for union.
|
|
*
|
|
* A comment block before the union definition is recommended to
|
|
* describe the general information of the union type. In the
|
|
* comment block, a `@brief` is required, other commands (such as `@note`)
|
|
* are optional.
|
|
*
|
|
* To describe the values of the union, document is recommended
|
|
* to be put after each value.
|
|
*
|
|
* See
|
|
* <a href="https://github.com/RT-Thread/rt-thread/blob/master/documentation/0.doxygen/example/include/union.h">documentation/0.doxygen/example/include/union.h</a>
|
|
* for example.
|
|
*/
|
|
|
|
/**
|
|
* @addtogroup group_doxygen_example
|
|
*/
|
|
|
|
/** @{ */
|
|
|
|
/**
|
|
* @brief Brief description of this union
|
|
*/
|
|
union doxygen_example_union
|
|
{
|
|
int v1; /**< description for v1 */
|
|
double v2; /**< description for v2 */
|
|
};
|
|
|
|
/** @} */
|
|
|
|
#endif /* _DOXYGEN_EXAMPLE_UNION_H_ */
|