[Development] How to build Qt5's docs?

[lars.knoll at nokia.com]

On Aug 18, 2012, at 3:19 PM, ext Loaden <loaden at gmail.com<mailto:loaden at gmail.com>> wrote:

I want to build Qt5's docs (qch), but failing always.

make docs >>doc.log 2>&1

Error Message:
threed.pro<http://threed.pro/> -o Makefile ) && make -f Makefile docs
make[3]: Entering directory `/home/loaden/qpSOFT/Projects/BuildQt5-x64/qt3d/src/threed'
/home/loaden/qpSOFT/Projects/BuildQt5-x64/qtbase/bin/qdoc -installdir /home/loaden/qpSOFT/Projects/BuildQt5-x64/qtbase/doc /home/loaden/qpSOFT/Projects/Qt5/qt3d/src/threed/doc/qt3d.qdocconf
/home/loaden/qpSOFT/Projects/Qt5/qt3d/src/threed/doc/qt3d.qdocconf:1: error: Cannot open file '/home/loaden/qpSOFT/Projects/Qt5/qt3d/src/threed/doc/../../../doc/global/qt-html-templates-offline.qdocconf': No such file or directory
Cannot open file '/home/loaden/qpSOFT/Projects/Qt5/qt3d/src/threed/doc/../../../doc/global/qt-html-templates-offline.qdocconf': No such file or directory

Aborting
make[3]: *** [docs] Error 1
make[3]: Leaving directory `/home/loaden/qpSOFT/Projects/BuildQt5-x64/qt3d/src/threed'
make[2]: *** [sub-threed-docs_ordered] Error 2
make[2]: Leaving directory `/home/loaden/qpSOFT/Projects/BuildQt5-x64/qt3d/src'
make[1]: *** [sub-src-docs] Error 2
make[1]: Leaving directory `/home/loaden/qpSOFT/Projects/BuildQt5-x64/qt3d'
make: *** [module-qt3d-docs] Error 2

Why?

There's currently two ways to build documentation. A modular one (the one you chose) and one way where we build global docs as in Qt 4. The first approach is still work in progress (even though it's what we want to have in the long term).

The second approach requires running qtdoc on some .qdocconf file in the qtdocs module (plus maybe some additional black magic ;-)

Cheers,
Lars

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20120820/503327da/attachment.html>