在doxygen中多次使用相同的文本

Question

我的功能很少，应该在doxygen中描述，其中80％的描述是相同的。 我可以将它复制粘贴到它们上面，但有时候这种描述正在改变，所有这些功能的支持变化都变得令人头疼。

在doxygen中是否有办法创建一个命名文本块，只需键入一次，每个函数都可以使用它？

类似的东西：

//! /textblock <supername> that is the text that I would like to have just once, but that should appears in different places in documentation
...
//! my function 1. /useblock <supername>. Just as it is.
void func1() { return; }
...
//! my function 2. /useblock <supername>. Yeah, make sense.
void func2() { return; }
...
//! my function 3. /useblock <supername>. Such great it is.
void func3() { return; }

Answer 1

我在doxygen中使用了“别名”自定义命令来实现“片段”。见http://www.doxygen.nl/manual/custcmd.html。虽然这个解释使得它看起来只能用于函数类型的东西，但它对于重复的文本来说非常有用。