Doxygen 1.7.4,名称包含" $$"在ANSI C中

时间:2016-12-12 16:17:36

标签: c linker doxygen keil

我在记录名称中包含双$(" $$")的变量时遇到问题。事实上,这些名称不是真正的变量,而是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像处理任何其他变量一样处理这些变量?

1 个答案:

答案 0 :(得分:1)

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

或者,您可以将违规声明放在单独的标题中,并从Doxygen处理中省略该标题(EXCLUDE和/ EXCLUDE_PATTERNS可以提供帮助)。

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