[Development] Qt5-beta2 qdoc.exe perhaps bug with QT_INSTALL_DOCS

[Pasion Jerome]

Hello,

We've been updating QDoc and the configuration files the past few months. The timing of your post is a bit awkward as we were merging the changes yesterday. I'm in the process of updating the QDoc guide and instructions.

1)Essentially, make sure you have the latest master branches.

2)Your qdocconf file should essentially look like this: http://qt-project.org/wiki/Qt5ModuleQDocconf
Note that the qhp titles match the titles specified in the documentation structure wiki. They are for setting the pages in Qt Creator and Assistant. For example, "Qt SQL C++ Classes".

3)You can follow the qdocconf files for most of the repositories in Qt 5 now.

Cheers,
Jerome P.

________________________________________
Fra: development-bounces+jerome.pasion=digia.com at qt-project.org [development-bounces+jerome.pasion=digia.com at qt-project.org] på vegne av Denis Shienkov [scapig2 at yandex.ru]
Sendt: 20. november 2012 16:17
To: development at qt-project.org
Emne: [Development] Qt5-beta2 qdoc.exe perhaps bug with QT_INSTALL_DOCS

Hello Qt developers.

When trying to build documentation for custom addon with qdoc for qt5-beta2 on Windows:

$nmake docs

I get the following error:

g:\Qt\Qt5.0.0beta2\5.0.0-beta2\msvc2010\bin\qdoc.exe
-outputdir G:/git/ng/qtserialport-build-Desktop_Qt_5_0_0_beta2_MSVC2010_32bit_SDK-Release/doc/qtserialport
-installdir g:\Qt\Qt5.0.0beta2\5.0.0-beta2\msvc2010\doc G:/git/ng/qtserialport/src/serialport/doc/serialport.qdocconf

G:/git/ng/qtserialport/src/serialport/doc/serialport.qdocconf:1: error:
Cannot open file 'Q:/qt5_workdir/w/s/qtbase/doc/global/qt-html-templates-offline.qdocconf': No such file or directory
Cannot open file 'Q:/qt5_workdir/w/s/qtbase/doc/global/qt-html-templates-offline.qdocconf': No such file or directory

My file 'serialport.qdocconf' contain lines:

include($QT_INSTALL_DOCS/global/qt-html-templates-offline.qdocconf)
include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf)

But from the build log shows that:

QT_INSTALL_DOCS = Q:/qt5_workdir/w/s/qtbase/doc  (INCORRECT!!!)

Although the profile of the Qt5 from QtCreator shows:

QT_INSTALL_DOCS = g:\Qt\Qt5.0.0beta2\5.0.0-beta2\msvc2010\doc  (CORRECT!!!)

I tried from the console cmd.exe before building documentation to force set path:

set QT_INSTALL_DOCS=g:\Qt\Qt5.0.0beta2\5.0.0-beta2\msvc2010\doc

but result is negative, same.


Please tell me how to solve the problem?

Best regards,
Denis







_______________________________________________
Development mailing list
Development at qt-project.org
http://lists.qt-project.org/mailman/listinfo/development