c - Doxygen 1.7.4,名称包含 ANSI C 中的 "$$"

标签 c linker doxygen keil

我在记录名称中包含 double$(“$$”)的变量时遇到问题。事实上,这些名称不是真正的变量,而是 Keil Linker 生成的常量。 $$ 对于 Doxygen 解析器来说似乎有特殊的(未记录?)含义。如果我写下面的代码

extern char SectionA$$Base[];     /** starting address of the section **/
extern char SectionA$$Limit[];    /** end address of the section  **/

Doxygen 提示未记录的变量 $$Base 和 $$Limit,将其包含在文档中,其中 $$ 使用粗体、链接等属性的奇怪组合以空格开头,并且没有任何注释。以这种方式声明的变量总数为 8。然而,文档输出包含 2 个或有时 4 个声明。所以 $$ 似乎有很大的影响,我不明白。

如何强制 Doxygen 像处理其他变量一样处理此变量?

最佳答案

据我所知,Doxygen 没有用于接受无效标识符的命令或配置选项。但是,它确实支持在处理输入文件之前对其进行过滤。您也许可以使用它来更改有问题的声明,或者将它们从传递给 Doxygen 的声明中删除。请参阅 INPUT_FILTERFILTER_PATTERNS 和相关配置选项。

或者,您可以将有问题的声明放在单独的 header 中,并在 Doxygen 处理中忽略该 header (EXCLUDE 和或 EXCLUDE_PATTERNS 可以提供帮助)。

我没有找到使用 Doxygen 实际生成这些标识符的文档的方法。

关于c - Doxygen 1.7.4,名称包含 ANSI C 中的 "$$",我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/41105048/

相关文章:

c++ - 复杂 C 语法的含义

此修订版需要代码建议

c++ - 如何摆脱完全专用函数模板的多个定义?

Doxygen - 在 gswin64c.exe 中使用 doxygen

qt - 如何通过 Doxygen 生成类似于 Qt 的文档?

c - 将指针数组传递给结构体

对 ioctl() 和内核头文件的混淆

compiler-construction - 编译 Debug模式时出错 : C++/CLI - error LNK2022

c++ - 包含 header 如何导致链接器错误?

c++ - 在 Doxygen 上逃逸,# 到底是什么意思?