From cc07564978525516794871155b805c93bc820654 Mon Sep 17 00:00:00 2001
From: Topi Reinio <topi.reinio@qt.io>
Date: Wed, 14 May 2025 10:43:27 +0000
Subject: [PATCH] Doc: Enable automatic linking to sources on code.qt.io

Since 6.10, QDoc is capable of generating links to the declaration in
the source code for each documented C++ API entity in their `Detailed
description`.

Add the required configuration to enable this feature in online
documentation builds.

Change-Id: Iaafabc5aea50a6cd72549bb1c04007bb4de498ca
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
---
 doc/config/exampleurl-qt3d.qdocconf              | 3 +++
 doc/config/exampleurl-qtactiveqt.qdocconf        | 3 +++
 doc/config/exampleurl-qtbase.qdocconf            | 3 +++
 doc/config/exampleurl-qtconnectivity.qdocconf    | 3 +++
 doc/config/exampleurl-qtdatavis3d.qdocconf       | 3 +++
 doc/config/exampleurl-qtdeclarative.qdocconf     | 3 +++
 doc/config/exampleurl-qtlocation.qdocconf        | 3 +++
 doc/config/exampleurl-qtmultimedia.qdocconf      | 3 +++
 doc/config/exampleurl-qtnetworkauth.qdocconf     | 3 +++
 doc/config/exampleurl-qtpositioning.qdocconf     | 3 +++
 doc/config/exampleurl-qtremoteobjects.qdocconf   | 3 +++
 doc/config/exampleurl-qtscxml.qdocconf           | 3 +++
 doc/config/exampleurl-qtsensors.qdocconf         | 3 +++
 doc/config/exampleurl-qtserialbus.qdocconf       | 3 +++
 doc/config/exampleurl-qtserialport.qdocconf      | 3 +++
 doc/config/exampleurl-qtspeech.qdocconf          | 3 +++
 doc/config/exampleurl-qtsvg.qdocconf             | 3 +++
 doc/config/exampleurl-qttools.qdocconf           | 3 +++
 doc/config/exampleurl-qtvirtualkeyboard.qdocconf | 3 +++
 doc/config/exampleurl-qtwayland.qdocconf         | 3 +++
 doc/config/exampleurl-qtwebchannel.qdocconf      | 3 +++
 doc/config/exampleurl-qtwebengine.qdocconf       | 3 +++
 doc/config/exampleurl-qtwebsockets.qdocconf      | 3 +++
 doc/config/exampleurl-qtwebview.qdocconf         | 3 +++
 doc/global/qt-module-defaults-online.qdocconf    | 3 +++
 src/concurrent/doc/qtconcurrent.qdocconf         | 3 +++
 src/corelib/doc/qtcore.qdocconf                  | 3 +++
 src/dbus/doc/qtdbus.qdocconf                     | 3 +++
 src/gui/doc/qtgui.qdocconf                       | 3 +++
 src/network/doc/qtnetwork.qdocconf               | 3 +++
 src/opengl/doc/qtopengl.qdocconf                 | 3 +++
 src/printsupport/doc/qtprintsupport.qdocconf     | 3 +++
 src/sql/doc/qtsql.qdocconf                       | 3 +++
 src/testlib/doc/qttestlib.qdocconf               | 3 +++
 src/widgets/doc/qtwidgets.qdocconf               | 3 +++
 src/xml/doc/qtxml.qdocconf                       | 3 +++
 36 files changed, 108 insertions(+)

diff --git a/doc/config/exampleurl-qt3d.qdocconf b/doc/config/exampleurl-qt3d.qdocconf
index 1a141514162..af56cf592c0 100644
--- a/doc/config/exampleurl-qt3d.qdocconf
+++ b/doc/config/exampleurl-qt3d.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qt3d.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qt3d.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtactiveqt.qdocconf b/doc/config/exampleurl-qtactiveqt.qdocconf
index f1abbd165e1..7ce20978e68 100644
--- a/doc/config/exampleurl-qtactiveqt.qdocconf
+++ b/doc/config/exampleurl-qtactiveqt.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtactiveqt.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtactiveqt.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtbase.qdocconf b/doc/config/exampleurl-qtbase.qdocconf
index b29df464ba4..5094c094a03 100644
--- a/doc/config/exampleurl-qtbase.qdocconf
+++ b/doc/config/exampleurl-qtbase.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtbase.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtbase.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtconnectivity.qdocconf b/doc/config/exampleurl-qtconnectivity.qdocconf
index 42923eb6732..4c38b223a2c 100644
--- a/doc/config/exampleurl-qtconnectivity.qdocconf
+++ b/doc/config/exampleurl-qtconnectivity.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtconnectivity.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtconnectivity.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtdatavis3d.qdocconf b/doc/config/exampleurl-qtdatavis3d.qdocconf
index 66f129a7731..0deee54ec57 100644
--- a/doc/config/exampleurl-qtdatavis3d.qdocconf
+++ b/doc/config/exampleurl-qtdatavis3d.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtdatavis3d.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtdatavis3d.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtdeclarative.qdocconf b/doc/config/exampleurl-qtdeclarative.qdocconf
index 4b1d751b609..ea6aa21a5ca 100644
--- a/doc/config/exampleurl-qtdeclarative.qdocconf
+++ b/doc/config/exampleurl-qtdeclarative.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtdeclarative.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtdeclarative.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtlocation.qdocconf b/doc/config/exampleurl-qtlocation.qdocconf
index 93d47fca135..39c271bb3b0 100644
--- a/doc/config/exampleurl-qtlocation.qdocconf
+++ b/doc/config/exampleurl-qtlocation.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtlocation.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtlocation.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtmultimedia.qdocconf b/doc/config/exampleurl-qtmultimedia.qdocconf
index b710693d315..0196e7bb6ca 100644
--- a/doc/config/exampleurl-qtmultimedia.qdocconf
+++ b/doc/config/exampleurl-qtmultimedia.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtmultimedia.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtmultimedia.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtnetworkauth.qdocconf b/doc/config/exampleurl-qtnetworkauth.qdocconf
index e71da43bb18..f71a287b67e 100644
--- a/doc/config/exampleurl-qtnetworkauth.qdocconf
+++ b/doc/config/exampleurl-qtnetworkauth.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtnetworkauth.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtnetworkauth.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtpositioning.qdocconf b/doc/config/exampleurl-qtpositioning.qdocconf
index f8fd478e93a..1e941660452 100644
--- a/doc/config/exampleurl-qtpositioning.qdocconf
+++ b/doc/config/exampleurl-qtpositioning.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtpositioning.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtpositioning.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtremoteobjects.qdocconf b/doc/config/exampleurl-qtremoteobjects.qdocconf
index 40c4c68bff2..e77ce6a13cd 100644
--- a/doc/config/exampleurl-qtremoteobjects.qdocconf
+++ b/doc/config/exampleurl-qtremoteobjects.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtremoteobjects.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtremoteobjects.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtscxml.qdocconf b/doc/config/exampleurl-qtscxml.qdocconf
index 2383f823ea8..434d43432b8 100644
--- a/doc/config/exampleurl-qtscxml.qdocconf
+++ b/doc/config/exampleurl-qtscxml.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtscxml.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtscxml.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtsensors.qdocconf b/doc/config/exampleurl-qtsensors.qdocconf
index 291a0e80858..d99c2266a40 100644
--- a/doc/config/exampleurl-qtsensors.qdocconf
+++ b/doc/config/exampleurl-qtsensors.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtsensors.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtsensors.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtserialbus.qdocconf b/doc/config/exampleurl-qtserialbus.qdocconf
index b263b510389..470c3717110 100644
--- a/doc/config/exampleurl-qtserialbus.qdocconf
+++ b/doc/config/exampleurl-qtserialbus.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtserialbus.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtserialbus.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtserialport.qdocconf b/doc/config/exampleurl-qtserialport.qdocconf
index 6b1e66b1d3c..73eed1070fa 100644
--- a/doc/config/exampleurl-qtserialport.qdocconf
+++ b/doc/config/exampleurl-qtserialport.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtserialport.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtserialport.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtspeech.qdocconf b/doc/config/exampleurl-qtspeech.qdocconf
index 0cb3b209bd8..41055280514 100644
--- a/doc/config/exampleurl-qtspeech.qdocconf
+++ b/doc/config/exampleurl-qtspeech.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtspeech.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtspeech.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtsvg.qdocconf b/doc/config/exampleurl-qtsvg.qdocconf
index 2514710f119..dd72974e358 100644
--- a/doc/config/exampleurl-qtsvg.qdocconf
+++ b/doc/config/exampleurl-qtsvg.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtsvg.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtsvg.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qttools.qdocconf b/doc/config/exampleurl-qttools.qdocconf
index 12a79f303db..ff83fd5ade6 100644
--- a/doc/config/exampleurl-qttools.qdocconf
+++ b/doc/config/exampleurl-qttools.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qttools.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qttools.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtvirtualkeyboard.qdocconf b/doc/config/exampleurl-qtvirtualkeyboard.qdocconf
index f9080346b31..b7147002930 100644
--- a/doc/config/exampleurl-qtvirtualkeyboard.qdocconf
+++ b/doc/config/exampleurl-qtvirtualkeyboard.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtvirtualkeyboard.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtvirtualkeyboard.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtwayland.qdocconf b/doc/config/exampleurl-qtwayland.qdocconf
index 65417434cee..7cc08688906 100644
--- a/doc/config/exampleurl-qtwayland.qdocconf
+++ b/doc/config/exampleurl-qtwayland.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtwayland.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtwayland.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtwebchannel.qdocconf b/doc/config/exampleurl-qtwebchannel.qdocconf
index e9926b29e6e..d5d7cb9cb38 100644
--- a/doc/config/exampleurl-qtwebchannel.qdocconf
+++ b/doc/config/exampleurl-qtwebchannel.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtwebchannel.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtwebchannel.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtwebengine.qdocconf b/doc/config/exampleurl-qtwebengine.qdocconf
index 27b28536ac6..121552a41bb 100644
--- a/doc/config/exampleurl-qtwebengine.qdocconf
+++ b/doc/config/exampleurl-qtwebengine.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtwebengine.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtwebengine.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtwebsockets.qdocconf b/doc/config/exampleurl-qtwebsockets.qdocconf
index 814f97b3e1b..15c1cf8a8cb 100644
--- a/doc/config/exampleurl-qtwebsockets.qdocconf
+++ b/doc/config/exampleurl-qtwebsockets.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtwebsockets.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtwebsockets.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/config/exampleurl-qtwebview.qdocconf b/doc/config/exampleurl-qtwebview.qdocconf
index 38a57352858..c8f0969a6a6 100644
--- a/doc/config/exampleurl-qtwebview.qdocconf
+++ b/doc/config/exampleurl-qtwebview.qdocconf
@@ -1 +1,4 @@
 url.examples = "https://code.qt.io/cgit/qt/qtwebview.git/tree/examples/\1?h=$QT_VER"
+
+# Automatic linking to declarations of C++ APIs
+url.sources  = "https://code.qt.io/cgit/qt/qtwebview.git/tree/\1?h=$QT_VER#n\2"
diff --git a/doc/global/qt-module-defaults-online.qdocconf b/doc/global/qt-module-defaults-online.qdocconf
index dbf2898deee..1d94a50f4e6 100644
--- a/doc/global/qt-module-defaults-online.qdocconf
+++ b/doc/global/qt-module-defaults-online.qdocconf
@@ -29,6 +29,9 @@ include(macros-online.qdocconf)
 #extra configuration data DITA information
 include(config.qdocconf)
 
+# Enable automatic linking to sources
+url.sources.enabled = true
+
 # single-directory output mode
 HTML.nosubdirs = "true"
 HTML.outputsubdir = "../html"
diff --git a/src/concurrent/doc/qtconcurrent.qdocconf b/src/concurrent/doc/qtconcurrent.qdocconf
index 0173be40d5c..db4b834432e 100644
--- a/src/concurrent/doc/qtconcurrent.qdocconf
+++ b/src/concurrent/doc/qtconcurrent.qdocconf
@@ -7,6 +7,9 @@ version                 = $QT_VERSION
 
 examplesinstallpath     = qtconcurrent
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtConcurrent
 
 qhp.QtConcurrent.file         = qtconcurrent.qhp
diff --git a/src/corelib/doc/qtcore.qdocconf b/src/corelib/doc/qtcore.qdocconf
index 2682cc0f8a4..d2b386373a0 100644
--- a/src/corelib/doc/qtcore.qdocconf
+++ b/src/corelib/doc/qtcore.qdocconf
@@ -10,6 +10,9 @@ includepaths           += ./include
 
 examplesinstallpath     = corelib
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtCore
 
 qhp.QtCore.file                = qtcore.qhp
diff --git a/src/dbus/doc/qtdbus.qdocconf b/src/dbus/doc/qtdbus.qdocconf
index 685b48eed30..cba7b653e44 100644
--- a/src/dbus/doc/qtdbus.qdocconf
+++ b/src/dbus/doc/qtdbus.qdocconf
@@ -25,6 +25,9 @@ excludedirs += ../../../examples/widgets/doc
 
 examplesinstallpath     = dbus
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 tagfile = qtdbus.tags
 
 depends += qtcore qtdoc qmake qtcmake
diff --git a/src/gui/doc/qtgui.qdocconf b/src/gui/doc/qtgui.qdocconf
index 1d677dbe2b7..24d9d522735 100644
--- a/src/gui/doc/qtgui.qdocconf
+++ b/src/gui/doc/qtgui.qdocconf
@@ -10,6 +10,9 @@ moduleheader            = QtGuiDoc
 
 examplesinstallpath     = gui
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtGui
 
 qhp.QtGui.file         = qtgui.qhp
diff --git a/src/network/doc/qtnetwork.qdocconf b/src/network/doc/qtnetwork.qdocconf
index 2d2765da2e9..12319c5c959 100644
--- a/src/network/doc/qtnetwork.qdocconf
+++ b/src/network/doc/qtnetwork.qdocconf
@@ -7,6 +7,9 @@ version                 = $QT_VERSION
 
 examplesinstallpath     = network
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtNetwork
 
 qhp.QtNetwork.file         = qtnetwork.qhp
diff --git a/src/opengl/doc/qtopengl.qdocconf b/src/opengl/doc/qtopengl.qdocconf
index 8d0a3998437..ec0e945371a 100644
--- a/src/opengl/doc/qtopengl.qdocconf
+++ b/src/opengl/doc/qtopengl.qdocconf
@@ -31,6 +31,9 @@ depends += qtcore qtgui qtwidgets qtdoc qmake qtcmake qtquick
 
 examplesinstallpath     = opengl
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 tagfile = qtopengl.tags
 
 # The following parameters are for creating a qhp file, the qhelpgenerator
diff --git a/src/printsupport/doc/qtprintsupport.qdocconf b/src/printsupport/doc/qtprintsupport.qdocconf
index f1b541bafbb..dc37db253d1 100644
--- a/src/printsupport/doc/qtprintsupport.qdocconf
+++ b/src/printsupport/doc/qtprintsupport.qdocconf
@@ -7,6 +7,9 @@ version                 = $QT_VERSION
 
 examplesinstallpath     = printsupport
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtPrintSupport
 
 qhp.QtPrintSupport.file         = qtprintsupport.qhp
diff --git a/src/sql/doc/qtsql.qdocconf b/src/sql/doc/qtsql.qdocconf
index 78c544454f5..2545bcf4050 100644
--- a/src/sql/doc/qtsql.qdocconf
+++ b/src/sql/doc/qtsql.qdocconf
@@ -7,6 +7,9 @@ version                 = $QT_VERSION
 
 examplesinstallpath     = sql
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtSql
 
 qhp.QtSql.file            = qtsql.qhp
diff --git a/src/testlib/doc/qttestlib.qdocconf b/src/testlib/doc/qttestlib.qdocconf
index 31b088579aa..a1f2cef704b 100644
--- a/src/testlib/doc/qttestlib.qdocconf
+++ b/src/testlib/doc/qttestlib.qdocconf
@@ -8,6 +8,9 @@ version                 = $QT_VERSION
 
 examplesinstallpath     = qtestlib
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtTestLib
 
 qhp.QtTestLib.file                = qttestlib.qhp
diff --git a/src/widgets/doc/qtwidgets.qdocconf b/src/widgets/doc/qtwidgets.qdocconf
index 0376ffc4469..a72b68024c6 100644
--- a/src/widgets/doc/qtwidgets.qdocconf
+++ b/src/widgets/doc/qtwidgets.qdocconf
@@ -10,6 +10,9 @@ includepaths           += -I./macOS
 
 examplesinstallpath     = widgets
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtWidgets
 
 qhp.QtWidgets.file         = qtwidgets.qhp
diff --git a/src/xml/doc/qtxml.qdocconf b/src/xml/doc/qtxml.qdocconf
index ffc679b1bd3..b778471298c 100644
--- a/src/xml/doc/qtxml.qdocconf
+++ b/src/xml/doc/qtxml.qdocconf
@@ -7,6 +7,9 @@ version                 = $QT_VERSION
 
 examplesinstallpath     = xml
 
+# Path to the root of qtbase (for automatic linking to source code)
+url.sources.rootdir     = ../../..
+
 qhp.projects            = QtXml
 
 qhp.QtXml.file            = qtxml.qhp