我应该如何使用Doxygen对typedef进行分类?

时间:2011-10-28 18:01:41

标签: c++ doxygen

我的C ++代码中有typedef结构。截至目前,它们被列为\var typedef。有一个更好的方法吗?以下是我的例子:

/*! \var typedef etc
 * \brief A type defined structure for etc 
 *
 * \param x type- Variable declaration for x
 * \param y type- Variable declaration for y
 */

我知道我甚至不应该说param。还有什么用?

2 个答案:

答案 0 :(得分:24)

如果将注释块放在typedef前面,则不需要使用任何特殊命令。

/** This is the documentation for the following typedef */
typedef MyClass MyTypedef;

如果您希望在typedef之后使用以下内容:

typedef MyClass MyTypedef;
/**< This is the documentation for the preceding typedef */

只有当注释块必须位于与实际typedef不同的位置时,才需要使用\ typedef。

答案 1 :(得分:11)

根据Doxygen documentation,有一个\typedef命令。该命令的行为与\var命令相同。