我正在研究一个大型的代码库(ANSI C,不是C++),并且为每个目标设备(各种嵌入式设备和Win32)都有一个平台特定的报头。
我想把那些标题需要定义的typedef和宏记录下来,我想在阅读了
Documentation at other places
一节。我把文档添加到
platform.h
包含目标平台头的文件。
我的目标平台标题(如
platform_win32.h
@file
标记,并按预期显示在文件列表中。当我单击该文件时,它会显示typedef和宏的列表,但它只显示
只有那个标题才有的
. 出现在多个标题中的任何宏/类型都没有文档记录。
有什么我能做的吗?我真的希望这些描述出现在多个文件中。这是某种命名空间问题吗?
这是疯狂的事情——我有两个宏并排记录在
平台.h
. 出现在
platform_foo.h
出现在全局列表中,但出现在
平台_win32.h
和
platform_bar.h
不会出现在列表中。
宏文档都不会出现在
平台.h
文件视图,这很有意义,因为宏和typedef不在该文件中使用——它只保存文档。
globals_0x78.html
(0x78='x',宏名的第一个字母)。我现在认为这可能与名称空间有关。查看一个文件的HTML源代码,我看到它被列为
group_name::MACRO_NAME
稍后再讨论--下次会议的时间。