====== Doxygen ======

[[http://micro-os-plus.github.io/develop/doxygen-style-guide/]]

<code c>
/**
 * @file ...
 * @brief ...
 * @author
 * @date 2024-12-01
 * @version 1.0
 */
</code>

<code c>
/**
 * @brief ...
 * @details
 * ...
 */
</code>

Function:

<code c>
/**
 * @brief ...
 *
 * @param [in] c  ...
 * @return int
 * @retval -1 Error
 * @retval 0 oK
 *
 * @details
 * ...

 */
</code>

Variables and macros:
<code c>
/**
 * @brief ...
 */
#define FOO 1

/**
 * @brief ...
 */
int poo;
</code>

Structs and enums:

<code c>
/**
 * @brief ...
 */
typedef struct {
  int a;  /**< a var */
  int b;  /**< b var */
} my_t;

</code>