无法生成qdoc文档

Question

按照本指南http://doc-snapshot.qt-project.org/qdoc/qdoc-guide-conf.html,我制作了一个简单的qdoc​​配置文件.

sourcedirs = ../sources

sources.fileextensions = "*.cpp *.qdoc *.mm *.qml"
headers.fileextensions = "*.h *.ch *.h++ *.hh *.hpp *.hxx"

outputdir  =    ./doc/
outputformats = HTML

但是,生成的文档文件夹为空,除了索引文件和几个文件夹.

有人可以帮忙解释一下吗？非常感谢!

Answer 1

让我回答我自己的问题。我刚刚发现设置 sourcedirs 是不够的。您还需要设置 headerdirs。

headerdirs = ../sources

这解决了这个问题。qdoc 首先搜索标头，然后搜索 .cpp 文件中的文档。qdoc 不会搜索头文件中的文档，但它需要头文件才能查找源文件。