我们可以在 doxygen 文档中创建自己的字段吗？

Question

我是 doxygen 的菜鸟，所以如果我问一个基本问题，请原谅。我已经阅读了完整的文档，但自己无法找到解决方案。这是我的代码中的内容:

typedef struct{
  uint32_t event;
  void (*action)(void);
} CommandChain;

CommandChain commandRepo[] = {
  {.event = 0, .action = NULL},
  {.event = 1, .action = Start_Timer},
  {.event = 2, .action = Start_Gps}
}

其中的操作对应于我在其他地方定义的函数。我需要创建一个 XML 输出，其中有一个事件字段和相应的操作。我需要它的可解析格式。喜欢:@event_id 2 @triggers Gps因此，我可以检查什么事件会触发什么操作。

PS。我知道“@”用于 doxygen 中的命令，只是用来让我的观点更清楚。

Answer 1

是的，请参阅doxygen's Custom Commands :

Here is an example of an alias definition with a single argument:

ALIASES += l{1}="\ref \1"

上面添加了对带有单个参数的 @l 命令的支持，该命令在输出中扩展为 \ref\1，其中 \1 是参数文本。我认为你可以用它来构建你需要的东西。