即使我的问题与此类似,所提供的答案也不能解决我的问题。
我正在尝试生成我的第一个QDoc
输出。为了测试它,现在我只有一条评论main.cpp
:
/*!
* \brief main
* \param argc
* \param argv
* \return
*
* bla bla bla
*/
int main(int argc, char *argv[])
{
// ...
这是我的配置文件:
#include(compat.qdocconf)
#include(fileextensions.qdocconf)
project = MyProject
outputdir = docs
outputformats = HTML
headerdirs = .
sourcedirs = .
exampledirs = .
imagedirs = ./images
问题 #1:在最小示例中,该project
字段不存在。但没有它,运行qdoc myproject.qdocconf
我得到:
qt.qdoc: "qdoc can't run; no project set in qdocconf file"
问题 #2:project
设置字段后,输出如下:
qt.qdoc: Start qdoc for MyProject in dual process mode: generate phase.
qt.qdoc: No include paths passed to qdoc; guessing reasonable include paths
(qdoc) Could not find the module header in include paths for module "MyProject" (include paths: QList() )
Artificial module header built from header dirs in qdocconf file
qt.qdoc: Parse source files for "MyProject"
qt.qdoc: Source files parsed for "MyProject"
qt.qdoc: End qdoc for MyProject in dual process mode: generate phase.
我不确定如何包含路径。在这里我找不到这样的include
命令。它创建了输出docs
目录,但它几乎是空的:只有myproject,index
文件在那里。
我必须做些什么来生成 HTML 文件?