我在记录名称中包含双$(" $$")的变量时遇到问题。事实上,这些名称不是真正的变量,而是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像处理任何其他变量一样处理这些变量?
答案 0 :(得分:1)
据我所知,Doxygen
没有接受无效标识符的命令或配置选项。但是,它确实支持在处理输入文件之前对其进行过滤。您可以使用它来改变违规声明,或者从传递给Doxygen的声明中删除它们。请参阅INPUT_FILTER
,FILTER_PATTERNS
和相关配置选项。
或者,您可以将违规声明放在单独的标题中,并从Doxygen处理中省略该标题(EXCLUDE
和/ EXCLUDE_PATTERNS
可以提供帮助)。
我没有看到使用Doxygen实际生成这些标识符的文档的方法。