command - Doxygen - 创建自定义命令

Question

我认为我的问题与这个问题基本相同，但没有得到很好的答案：Create new custom command that will add to a section in Doxygen

我非常想做同样的事情，我想。我想完全复制@param选项的确切功能，除了给它标题“选项”而不是“参数”。我希望参数相同（数据类型、变量名和描述），并希望它们看起来都一样。从字面上看，我唯一需要不同的是标题。

我也试过这样做：

ALIASES = option"\par Options:\n"

在我的 Doxyfile 中，但我也在其自己的部分中获得了每个单独的选项，而不是所有选项都在同一部分中。它们也没有与@param选项相同的参数。

我还尝试做一些\xrefitem当然没有用的事情。我试过这个：

ALIASES = option="\xrefitem param \"Option\" \"Options\" "

但它看起来像是\xrefitem用于创建更像是来自不同部分的编译列表，例如 Todo 列表。

非常感谢您的帮助。谢谢！

编辑：

为了澄清，我正在寻找的输出看起来像这样：

选项：
string $option1 这是选项 1。
string $option2 这是选项 2。

score 0 · Accepted Answer

我很确定如果不修改 doxygen，这是不可能的。我只会使用 \li 并列出选项而不是使用 \param 然后。

score 0 · Accepted Answer

我能想到的最接近的是使用这个：

@par Options:
@li @e string @b $option1 This is option 1.
@li @e string @b $option2 This is option 2.

这几乎可以正常工作，只是它不能很好地排列每个部分，就像@param. 因此，如果第一个选项的名称是 like$option1而第二个选项的名称是$thisIsTheSecondOption，则说明的开头不会排列。它看起来更像：

选项：
字符串 $option1 这是选项 1。
int $thisIsTheSecondOption 这是选项 2。

这使得阅读变得更加困难。

:-\

2 回答 2