qtcreator的开发者在实现的过程已经在源代码里嵌入了源码的说明性文字。可以提取源码中的这些说明性文字,生成与qt库在线帮助网页类似的html帮助文档。


qt提供了QDoc工具。QDoc工具会提取.cpp和.doc文件中的指定格式的注释,以生成html或者xml文档。当前的QDoc工具名称叫qdoc3,可以在qt程序所在的bin目录下找到。运行QDoc时还需要一个配置文件,该文件的后缀为.qdocconf。这个配置文件告诉QDoc去什么地方找.cpp文件、.qdoc文件、产生的文档应该输出到什么地方、应该输出什么格式的文档等。

我所使用的qtcreator的源码版本是qt-creator-2.0.1-src;当前最新的源码版本是qt-creator-2.3.0-src。这两个版本的目录结构的内容有小的差别。

进入qt-creator-2.0.1-src/doc/api目录,
其下有名为qtcreator-api.qdocconf的配置文件,
运行命令:qdoc3 qtcreator-api.qdocconf
结束后会产生一个名为html的文件夹,这就是所生成的文档,html/index.html为文档首页。

注意:
1 qt-creator-2.0.1-src版本的的doc/api/qtcreator-api.qdoc文件有些问题。找到Find::ResultWindowItem所在的行,删除“, \l{Find::ResultWindowItem}“。否则,运行qdoc3时会提示不能为Find::ResultWindowItem函数创立链接(源码里没有这个函数)。
2 qt-creator-2.0.1-src/doc也有一些QDoc的配置文件,这些配置文件是用来生存qtcreator的使用帮助文档(不是源代码说明文档)的。
如需生成该文档,按如下操作:
进入qt-creator-2.0.1-src目录
运行命令:qmake (产生Makefile)
运行命令:make docs
产生的文档在qt-creator-2.0.1-src/doc/html文件夹中

参考链接:
http://doc.qt.nokia.com/qdoc/01-qdoc-manual.html
http://hi.baidu.com/cyclone/blog/item/a8b5277f247d3f0628388aa0.html