doxygen 标记文件中到底包含什么？

Question

根据文档，您总是使用指向一组 HTML 文件的 doxygen 标记文件。那么标记文件本身到底有什么作用呢？对于生成 700 个 HTML 文件的中等规模项目，我的标记文件为 500Kb，因此其中显然有很多内容。但是，为什么我不直接告诉 doxygen 外部文档的位置呢？

Answer 1

标签文件就像 C 语言的预编译头文件。它包含外部项目中的所有符号，以及每个符号到相应 HTML 文档的深层链接。它只是一个 XML 文件，因此您可以打开它并查看里面的内容。

您不能只告诉 doxygen 外部文档的位置，因为这样它就没有每个​​符号的深层链接的信息。它所能做的就是指向文档树的根，但这对用户来说不太友好。

理论上，doxygen 可以尝试直接从生成的 HTML 文件中提取链接。事实上，这在过去是可能的，但它非常脆弱，并且经常损坏，因此该功能被删除。