Cannot create qdoc documentation

Question

Following this guide http://doc-snapshot.qt-project.org/qdoc/qdoc-guide-conf.html , I made a simple qdoc configuration file.

sourcedirs = ../sources

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

outputdir  =    ./doc/
outputformats = HTML

However, the created documenation folder is empty, with the exception of the index file and several folders.

Can someone explain this? Many thanks!

Answer 1

Let me answer my own question. I just realized that the installation of sources is too small. You also need to configure headerdirs.

headerdirs = ../sources

This solves the problem. Qdoc first looks for headers and then looks for .cpp files for documentation. qdoc does not search for documentation in header files, but header files are required to search for source files.

Answer 2

.

C:\Qt\Qt5.3.1\...\bin\qdoc.exe your.qdocconf

. .

sourcedirs = ../sources

qdoc.

QDoc QDoc .h. .cpp .qdoc.