summaryrefslogtreecommitdiffstats
path: root/src/qdoc/doc/config/qdoc.qdocconf
diff options
context:
space:
mode:
authorLuca Di Sera <luca.disera@qt.io>2023-04-11 14:38:38 +0200
committerLuca Di Sera <luca.disera@qt.io>2023-04-12 15:06:56 +0200
commit846c860b89ee5fbef4f1db583bd951f8a33e196a (patch)
treef29b0f8ae9c1ab4d796e11e7b72cc56347e8a5e5 /src/qdoc/doc/config/qdoc.qdocconf
parent2ba87cd00e6527dbd64f5884f29081bd535605bb (diff)
QDoc: Move QDoc source files under a further "qdoc" directory
QDoc development under the "qttools" repository is currently performed under the "src/qdoc" directory, which contains all source files and directories relevant to QDoc as direct children. Due to a slow restructuring of how QDoc works, what its dependencies are and certain possible architectural changes, the infrastructure that is expected to be required for the development of QDoc might increase. Some of that infrastructure, which might require some custom effort, is expected to be developed as "independent" "library-like" sub-projects, which QDoc depends on. Albeit developed "independently", such infrastructure would be developed specifically for QDoc and thus should live "adjacent" to it. To allow such a structure a new "qdoc" directory was added under the "src/qdoc" directory. All source files and directory that were previously children of the "src/qdoc" directory were moved under the new "qdoc" directory. This preserves the space for QDoc-related elements and the relative project structure while allowing some space for "adjacent" projects that are intended for QDoc specifically. To support the change, a new "CMakeLists.txt" file was introduced under "src/qdoc", which dispatches to the "CMakeLists.txt" file in the new "src/qdoc/qdoc" directory. QDoc is only built when certain dependencies are found. This is supported through the use of Qt features at the CMake level. The "CMakeLists.txt" file in "src", thus dispatched to the "src/qdoc" directory only when the required features were found. As "independent", "library-like", entities might not have the same requirements as QDoc, the "CMakeLists.txt" file in "src" was modified to always dispatch to the "src/qdoc" directory while the features-check was moved to the new "CMakeLists.txt" files in "src/qdoc", so as to allow non-QDoc but QDoc-specific project to have an independent configuration for building. Certain test projects in "test/auto/qdoc/" depends on QDoc-specific source-files to generate their CMake targets. Those dependencies were generally specified as relative paths. The additional level in the directory structure invalidated the paths and, hence, the relevant "CMakeLists.txt" files for those projects were modified to correctly refer to the new directory structure. Change-Id: I50c7106614428753544eaba5091e1e44d48fd31d Reviewed-by: Topi Reiniƶ <topi.reinio@qt.io>
Diffstat (limited to 'src/qdoc/doc/config/qdoc.qdocconf')
-rw-r--r--src/qdoc/doc/config/qdoc.qdocconf59
1 files changed, 0 insertions, 59 deletions
diff --git a/src/qdoc/doc/config/qdoc.qdocconf b/src/qdoc/doc/config/qdoc.qdocconf
deleted file mode 100644
index 982615da9..000000000
--- a/src/qdoc/doc/config/qdoc.qdocconf
+++ /dev/null
@@ -1,59 +0,0 @@
-include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf)
-include($QT_INSTALL_DOCS/config/exampleurl-qttools.qdocconf)
-
-project = QDoc
-description = QDoc Manual
-version = $QT_VERSION
-moduleheader =
-
-sourcedirs = ..
-
-exampledirs = .. \
- ../examples
-
-imagedirs = ../images
-
-tagfile = ../html/qdoc.tags
-
-examples.fileextensions = "*.cpp *.h *.js *.xq *.svg *.xml *.ui *.qhp *.qhcp *.qml *.css *.qdoc *.qdocinc *.sample"
-
-qhp.projects = QDoc
-
-qhp.QDoc.file = qdoc.qhp
-qhp.QDoc.namespace = org.qt-project.qdoc.$QT_VERSION_TAG
-qhp.QDoc.virtualFolder = qdoc
-qhp.QDoc.indexTitle = QDoc Manual
-qhp.QDoc.indexRoot =
-
-qhp.QDoc.subprojects = overviews
-qhp.QDoc.subprojects.overviews.title = Overviews
-qhp.QDoc.subprojects.overviews.indexTitle = QDoc Manual
-qhp.QDoc.subprojects.overviews.selectors = doc:page
-
-depends += \
- qtconcurrent \
- qtcore \
- qtdbus \
- qtdesigner \
- qtdoc \
- qthelp \
- qtgui \
- qtlinguist \
- qtnetwork \
- qtopengl \
- qtprintsupport \
- qtqml \
- qtquick \
- qtquickcontrols \
- qtsql \
- qtsvg \
- qttestlib \
- qtuitools \
- qtwidgets \
- qtxml
-
-ignorewords += QDoc
-
-navigation.landingpage = "QDoc Manual"
-
-warninglimit = 0