Doc: Use \inmodule for all classes and headers
QDoc made some assumptions about the module a class/header belongs to, based on the source file path. This feature is rather error-prone and unnecessarily complex and will be removed from QDoc. Define modules explicitly to avoid documentation warnings when this removal happens. Pick-to: 6.2 6.3 Change-Id: I7947d197db5ac36c12e816caa19bb2f74eda8849 Reviewed-by: Edward Welbourne <edward.welbourne@qt.io> Reviewed-by: Mårten Nordheim <marten.nordheim@qt.io> Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
This commit is contained in:
parent
8c4dee6f97
commit
b99c08dd4e
@ -47,6 +47,7 @@ QT_BEGIN_NAMESPACE
|
||||
|
||||
/*!
|
||||
\headerfile <QtEndian>
|
||||
\inmodule QtCore
|
||||
\title Endian Conversion Functions
|
||||
\ingroup funclists
|
||||
\brief The <QtEndian> header provides functions to convert between
|
||||
|
@ -698,6 +698,7 @@ static_assert(sizeof(qint64) == 8, "Internal error, qint64 is misdefined");
|
||||
|
||||
/*!
|
||||
\headerfile <QtGlobal>
|
||||
\inmodule QtCore
|
||||
\title Global Qt Declarations
|
||||
\ingroup funclists
|
||||
|
||||
|
@ -170,6 +170,7 @@ void QTransposeProxyModelPrivate::onRowsAboutToBeMoved(const QModelIndex &source
|
||||
/*!
|
||||
\since 5.13
|
||||
\class QTransposeProxyModel
|
||||
\inmodule QtCore
|
||||
\brief This proxy transposes the source model.
|
||||
|
||||
This model will make the rows of the source model become columns of the proxy model and vice-versa.
|
||||
|
@ -43,7 +43,7 @@ QT_BEGIN_NAMESPACE
|
||||
|
||||
/*!
|
||||
\class QBaseIterator
|
||||
|
||||
\inmodule QtCore
|
||||
QBaseIterator forms the common base class for all iterators operating on
|
||||
subclasses of QIterable.
|
||||
*/
|
||||
|
@ -27,6 +27,7 @@
|
||||
|
||||
/*!
|
||||
\headerfile <QtMath>
|
||||
\inmodule QtCore
|
||||
\title Generic Math Functions
|
||||
\ingroup funclists
|
||||
|
||||
|
@ -27,6 +27,7 @@
|
||||
|
||||
/*!
|
||||
\headerfile <QtPlugin>
|
||||
\inmodule QtCore
|
||||
\title Defining Plugins
|
||||
\keyword qtplugin-defining-plugins
|
||||
\ingroup plugins
|
||||
|
@ -50,7 +50,7 @@ QT_BEGIN_NAMESPACE
|
||||
|
||||
/*!
|
||||
\headerfile <QtCborCommon>
|
||||
|
||||
\inmodule QtCore
|
||||
\brief The <QtCborCommon> header contains definitions common to both the
|
||||
streaming classes (QCborStreamReader and QCborStreamWriter) and to
|
||||
QCborValue.
|
||||
|
@ -1125,6 +1125,7 @@ const QCalendarBackend *QCalendarBackend::gregorian()
|
||||
|
||||
/*!
|
||||
\class QCalendar::SystemId
|
||||
\inmodule QtCore
|
||||
\since 6.2
|
||||
|
||||
This is an opaque type used to identify custom calendar implementations. The
|
||||
|
@ -27,6 +27,7 @@
|
||||
|
||||
/*!
|
||||
\headerfile <QtAlgorithms>
|
||||
\inmodule QtCore
|
||||
\title Generic Algorithms
|
||||
\ingroup funclists
|
||||
\keyword generic algorithms
|
||||
|
@ -832,6 +832,7 @@ size_t qHash(QLatin1String key, size_t seed) noexcept
|
||||
|
||||
/*!
|
||||
\class QHashSeed
|
||||
\inmodule QtCore
|
||||
\since 6.2
|
||||
|
||||
The QHashSeed class is used to convey the QHash seed. This is used
|
||||
|
@ -2516,6 +2516,7 @@ QAccessibleTableCellInterface::~QAccessibleTableCellInterface()
|
||||
|
||||
/*!
|
||||
\class QAccessibleTableInterface
|
||||
\inmodule QtGui
|
||||
\ingroup accessibility
|
||||
|
||||
\brief The QAccessibleTableInterface class implements support for
|
||||
@ -2662,6 +2663,7 @@ QAccessibleTableInterface::~QAccessibleTableInterface()
|
||||
|
||||
/*!
|
||||
\class QAccessibleActionInterface
|
||||
\inmodule QtGui
|
||||
\ingroup accessibility
|
||||
|
||||
\brief The QAccessibleActionInterface class implements support for
|
||||
|
@ -48,6 +48,7 @@ QT_BEGIN_NAMESPACE
|
||||
|
||||
/*!
|
||||
\class QAccessiblePlugin
|
||||
\inmodule QtGui
|
||||
\brief The QAccessiblePlugin class provides an abstract base class
|
||||
for plugins provinding accessibility information for user interface elements.
|
||||
|
||||
|
@ -374,6 +374,7 @@ QDebug operator<<(QDebug dbg, const QPageRanges &pageRanges)
|
||||
|
||||
/*!
|
||||
\struct QPageRanges::Range
|
||||
\inmodule QtGui
|
||||
\brief The QPageRanges::Range struct holds the \c from and \c to endpoints of a range.
|
||||
|
||||
\sa QPageRanges::toRangeList()
|
||||
|
@ -915,6 +915,7 @@ QDoubleValidator::Notation QDoubleValidator::notation() const
|
||||
|
||||
/*!
|
||||
\class QRegularExpressionValidator
|
||||
\inmodule QtGui
|
||||
\brief The QRegularExpressionValidator class is used to check a string
|
||||
against a regular expression.
|
||||
|
||||
|
@ -315,6 +315,7 @@ QVulkanInstance::~QVulkanInstance()
|
||||
|
||||
/*!
|
||||
\class QVulkanLayer
|
||||
\inmodule QtGui
|
||||
\brief Represents information about a Vulkan layer.
|
||||
*/
|
||||
|
||||
@ -368,6 +369,7 @@ QVulkanInstance::~QVulkanInstance()
|
||||
|
||||
/*!
|
||||
\class QVulkanExtension
|
||||
\inmodule QtGui
|
||||
\brief Represents information about a Vulkan extension.
|
||||
*/
|
||||
|
||||
@ -411,6 +413,7 @@ QVulkanInstance::~QVulkanInstance()
|
||||
|
||||
/*!
|
||||
\class QVulkanInfoVector
|
||||
\inmodule QtGui
|
||||
\brief A specialized QList for QVulkanLayer and QVulkanExtension.
|
||||
*/
|
||||
|
||||
|
@ -417,6 +417,7 @@ QNetworkInformationBackendFactory::~QNetworkInformationBackendFactory()
|
||||
|
||||
/*!
|
||||
\class QNetworkInformation
|
||||
\inmodule QtNetwork
|
||||
\since 6.1
|
||||
\brief QNetworkInformation exposes various network information
|
||||
through native backends.
|
||||
|
@ -44,6 +44,7 @@ QT_BEGIN_NAMESPACE
|
||||
|
||||
/*!
|
||||
* \class QOpenGLPixelTransferOptions
|
||||
* \inmodule QtOpenGL
|
||||
*
|
||||
* \brief The QOpenGLPixelTransferOptions class describes the pixel storage
|
||||
* modes that affect the unpacking of pixels during texture upload.
|
||||
|
Loading…
x
Reference in New Issue
Block a user