[Interest] Problem building docs in dev branch and out-of-source build

Sean Harmer sean.harmer at kdab.com
Thu Jan 1 20:42:12 CET 2015


On 01/01/2015 18:16, Guido Seifert wrote:
> Hiya,
> for the new year I gave me a new Qt5. :-)
> It is the dev branch. And for the first time I tried an out-of-source build for Qt5.
> No problem for qt itself, but something is very wrong with the docs.
> I did the usual
> 'make docs' and 'make install_docs' and for out-of-source:
> make install_global_docs
> So far so good. Plenty of qch files are installed. However, they are all useless.
> In Assistant all pages give me:
>> The page could not be found!
>> Error loading: qthelp://org.qt-project.qtprintsupport.550/qtprintsupport/qtprintsupport/qtprintsupport-index.html
>> Please make sure that you have all documentation sets installed.
> It looks like all indices are missing. Strangely the also created html documents seem to be complete and working.
> Any ideas what could cause this problem? I suppose it has something to do with the out-of-source build.

Yup. I hit this when starting to work on docs for Qt3D. See my findings in


In summary, the urls in the qhp files are getting a superfluous 
directory name added to them. As a temporary work around, comment out 
the line

outSubDir_ = Generator::outputSubdir();

in the ctor of node.cpp in qtbase/src/tools/qdoc/ to get correctly 
generated qhp and then qch files.

I'm waiting for feedback from Martin as to the correct fix.

Happy New Year!


Dr Sean Harmer | sean.harmer at kdab.com | Managing Director UK
Klarälvdalens Datakonsult AB, a KDAB Group company
Tel. Sweden (HQ) +46-563-540090, USA +1-866-777-KDAB(5322)
KDAB - Qt Experts - Platform-independent software solutions

More information about the Interest mailing list