From bfc975db586dc3629bd14e9f6ec1d2c085405faf Mon Sep 17 00:00:00 2001 From: Topi Reinio Date: Mon, 4 Aug 2025 11:13:53 +0000 Subject: [PATCH] Doc: Fix incorrect usage of \generatelist The \generatelist command takes an optional argument that affect how the members are listed, for example, `classesbymodule` which creates an annotated list of the classes in a named C++ module. `groupsbymodule` is not recognized or documented. QDoc falls back to generating a list of all members of a group in this case. While the end result is correct, this relies on an undocumented feature that is likely to change and break. Replace these instances with an explicit \annotatedlist command that produces the same output. Pick-to: 6.10 Task-number: QTBUG-138901 Change-Id: Iffa5720e53177d1b996d49f9a607e2a1fa91bb0a Reviewed-by: Paul Wicking --- src/grpc/doc/src/qtgrpc-index.qdoc | 2 +- src/protobuf/doc/src/qtprotobuf.qdoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/grpc/doc/src/qtgrpc-index.qdoc b/src/grpc/doc/src/qtgrpc-index.qdoc index 93f5eadc..b319c400 100644 --- a/src/grpc/doc/src/qtgrpc-index.qdoc +++ b/src/grpc/doc/src/qtgrpc-index.qdoc @@ -105,5 +105,5 @@ Furthermore, Qt GRPC in Qt \QtVersion may contain third party modules under the following permissive licenses: - \generatelist{groupsbymodule attributions-qtgrpc-examples} + \annotatedlist attributions-qtgrpc-examples */ diff --git a/src/protobuf/doc/src/qtprotobuf.qdoc b/src/protobuf/doc/src/qtprotobuf.qdoc index 355f7336..baa47f37 100644 --- a/src/protobuf/doc/src/qtprotobuf.qdoc +++ b/src/protobuf/doc/src/qtprotobuf.qdoc @@ -113,7 +113,7 @@ Furthermore, the \c qtprotobufgen tool in Qt \QtVersion may contain third party modules under the following permissive licenses: - \generatelist{groupsbymodule attributions-qtprotobuf-tools} + \annotatedlist attributions-qtprotobuf-tools */ /*!