QDoc: Resolve QML method links with signatures
Dotted QML method links cannot distinguish overloads by parameter
type. Authors must switch to C++ notation to select a particular
overload. Malformed signatures can also silently select an overload,
leaving readers with misleading links.
Allow dotted references to select QML method overloads and sections
in their documentation. Preserve C++-style references and warn about
invalid signatures instead of silently choosing a target.
[ChangeLog][QDoc] QML method links support dotted syntax with parameter
types for overload selection. Invalid signatures produce warnings
instead of silently selecting an overload.
Pick-to: 6.12
Task-number: QTBUG-137279
Change-Id: I2cdc1a2b7aa1f7d88b4f915cb2e822045c24ce40
Reviewed-by: Topi Reinio <topi.reinio@qt.io>
| commit | 367e88150e71046c60e94cc112b3d8c5e1772376 |
| parent | b6f337d72becba1eb87afdac0a088eaad90621e6 |
| author | David Boddie <david.boddie@qt.io> |
| committer | Paul Wicking <paul.wicking@qt.io> |
| commit time | Wed, 21 Oct 2026 18:28:02 +0000 |
- M src/qdoc/qdoc/src/qdoc/parameters.cpp
- M src/qdoc/qdoc/src/qdoc/parameters.h
- M src/qdoc/qdoc/src/qdoc/qdocdatabase.cpp
- M src/qdoc/qdoc/src/qdoc/qdocdatabase.h
- M src/qdoc/qdoc/tests/qdoc/CMakeLists.txt
- A src/qdoc/qdoc/tests/qdoc/parameters/catch_parameters.cpp
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/QmlMethods-qdoc-warnings.log
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/collision-qmlmodule.html
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/qml-testmodule-baseitem-members.html
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/qml-testmodule-baseitem.html
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/qml-testmodule-collision-members.html
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/qml-testmodule-collision.html
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/qmlmethods.index
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/expected/testmodule-qmlmodule.html
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/qml_methods.qdocconf
- A src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/qml_methods/src/types.qdoc