QDoc: Preserve related links across module builds
Documentation for dependent modules relies on index files to link
to related non-members. Enabling WebXML output can change the
identities recorded in these files. A dependent module can then
associate a related non-member with the wrong declaration or fail
to resolve its links.
Give related non-members consistent identities in each index file,
regardless of the selected output formats. This preserves links to
their documentation when dependent modules load the index in a
separate run. WebXML output remains unchanged.
Task-number: QTBUG-150820
Fixes: QTBUG-151066
Pick-to: 6.12
Change-Id: Ied101cb33395dbe9d8d5d148eed0315716bb10e6
Reviewed-by: David Boddie <david.boddie@qt.io>
| commit | aaa1ba6136331d22b60aeb1b28ece35a9156b52e |
| parent | 7cdba8e8a7ae90df97bd8b40cd2f47f2db9d17c3 |
| author | Paul Wicking <paul.wicking@qt.io> |
| committer | Paul Wicking <paul.wicking@qt.io> |
| commit time | Mon, 5 Oct 2026 13:54:16 +0000 |
- M src/qdoc/qdoc/src/qdoc/qdocindexfiles.cpp
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/build-order.txt
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/expected/relatedindexlinks/html/related-index-links-index.html
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/expected/relatedindexlinks/html/relatedindexlinks-module.html
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/expected/relatedindexlinks/html/relatedindexlinks.index
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/expected/relatedindexlinks/template-html/related-index-links-index.html
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/expected/relatedindexlinks/template-html/relatedindexlinks-module.html
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/related_index_links.qdocconf
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/src/consumer/related_index_links.qdoc
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/src/producer/widget.cpp
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/src/producer/widget.h
- A src/qdoc/qdoc/tests/multimoduleconfigurations/testdata/related_index_links/upstream_related.qdocconf
- M src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/comprehensiveproject_headerdocs/expected/html/test.index
- M src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/hiddenfriends_fn/expected/html/hiddenfriendsfn.index
- M src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/privatemembers/expected/html/privatemembers.index
- M src/qdoc/qdoc/tests/validateqdocoutputfiles/testdata/relates_scope/expected/html/relatesscope.index