我正在使用Doxygen 1.8.14,在生成的文档中,每个与类相对应的html文件顶部的类成员函数的简要说明,以及在同一html文档中对此类函数的所有提及均指向完整内容。功能文档通过超链接在页面的下方。
但是,对于不是类成员的函数,这不会发生(两种情况)。
在我看来,Doxygen似乎坏了,或者我缺少什么?我相信根据文档,这应该可行。
答案 0 :(得分:2)
Doxygen在一定程度上是从JavaDoc派生的,它是以类为中心的。因此,不是类成员的文档化元素必须是 something 的成员,才能出现在文档中。
您的选择是使他们成为文档化文件的成员(这要求您对它们在其中的文件进行文档化),文档化的命名空间,或通过\addtogroup
等将它们添加到现有文档模块/组中。文档工具。
这不一定是一件坏事。文档模块对于分离相关功能/类非常有用。记录文件和名称空间也很好,这样用户可以看到每个文件或名称空间的一部分的列表。