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

【问题标题】：Can we create our own field in doxygen documentation?我们可以在 doxygen 文档中创建自己的字段吗？
【发布时间】：2014-07-07 09:31:54
【问题描述】：

我是 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}
}

action 对应于我在别处定义的功能。我需要创建一个 XML 输出，其中有一个 Event 字段和一个相应的 Action。我需要它以可解析的格式。喜欢：@event_id 2 @triggers Gps 所以，我可以检查什么事件会触发什么动作。

PS。我知道 '@' 用于 doxygen 中的命令，只是为了让我的观点更清楚。

【问题讨论】：

标签： c doxygen

【解决方案1】：

是的，见doxygen's Custom Commands：

这是一个带有单个参数的别名定义示例：

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

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

【讨论】：