qt - 无法生成 idoc 文档

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 不会在头文件中搜索文档，但它需要头文件才能找到源文件。