我正在使用Doxygen记录我用C ++编写的一个小的实用程序模块。
我开始使用主标题中的\defgroup
创建一个组。
每个文件都围绕一个特定的需求,因此我认为我会使用\ingroup
将所有类,函数等放在子模块中,并每次使用\defgroup
在文件底部创建一个组。
这对我的所有文件(例如CombineHash.hpp)都非常有效,但对其中一个文件(Matrix.hpp)却不起作用:doxygen可以检测到它(我可以在文件列表中看到该文件),但是没有文档除了显示我使用的标准库头文件外,都会生成。
请注意,所有函数,类等都在同一个命名空间(utils)中,未记录。
我尝试了一些解决方法:开启和关闭EXTRACT_ALL的值,将\file
放在文件的开头,将UTILS_MATRIX子模块移出主UTILS模块,将文件移至文件的根目录。目录,或者使用Doxywizard和CLI,但是没有运气。每次输出中存在文件时,文件都会为空,但包含的STL标头除外。
我的目录树如下:
test/
├ src/
│ ├ Utils.hpp
│ └ Utils/
│ ├ Matrix.hpp
│ └ CombineHash.hpp
└ doc/
├ Doxyfile
└ html/
└ <doxygen-generated files>
我当然将RECURSIVE设置为true。
我正在Windows 10上使用doxygen版本1.8.15。
谢谢!