Allow qdocconf to specify where the examples are located in install.
authorEike Ziller <eike.ziller@digia.com>
Mon, 26 Nov 2012 12:54:43 +0000 (13:54 +0100)
committerThe Qt Project <gerrit-noreply@qt-project.org>
Mon, 26 Nov 2012 14:01:12 +0000 (15:01 +0100)
commit274407f347c56d7ace9651c21a03d7bc0ab50f78
tree82ebdbfec6a77b1d05c5354979c503ee67d8f433
parenta2ab156872195e0398f4cfe1992b526aa1315c76
Allow qdocconf to specify where the examples are located in install.

We have qdoc configurations for the different qtbase libraries and
modules now, which specify e.g. "../../../examples/opengl" for the
exampledirs. That means that qdoc finds examples like
"2dpainting/2dpainting.pro" which is then installed into
"[QT_INSTALL_EXAMPLES]/opengl/2dpainting/2dpainting.pro". (At the moment
even into "[QT_INSTALL_EXAMPLES]/qtbase/opengl/...", which will be
changed to match the structure in source.)

In order for Qt Creator to find the examples, qdoc must write the path
behind [QT_INSTALL_EXAMPLES] into the example manifest file. This patch
introduces "examplesinstallpath" that allows qdoc configs to specify the
missing part, e.g. the opengl qdocconf can add

examplesinstallpath = opengl

to tell qdoc that the examples will be installed into
"[QT_INSTALL_EXAMPLES]/opengl/"

Task-number: QTBUG-27801
Change-Id: Idf518e16d3ca0f9522b084e92f34725b93e9d11f
Reviewed-by: Martin Smith <martin.smith@digia.com>
src/tools/qdoc/config.h
src/tools/qdoc/htmlgenerator.cpp
src/tools/qdoc/htmlgenerator.h