Fix some qdoc warnings
src/corelib/tools/qhash.cpp:2596: (qdoc) warning: clang found diagnostics parsing \fn template <class Key, class T> template <class InputIterator> QMultiHash::QMultiHash(InputIterator begin, InputIterator end) error: 'QMultiHash' is not a class, namespace, or enumeration src/corelib/kernel/qobject.cpp:4593: (qdoc) warning: Undocumented parameter 'EXPORT_MACRO' in QObject::Q_NAMESPACE_EXPORT src/corelib/global/qfloat16.cpp:129: (qdoc) warning: Cannot tie this documentation to anything src/corelib/text/qlocale.qdoc:1204: (qdoc) warning: Overrides a previous doc src/corelib/text/qlocale.qdoc:1187: (qdoc) warning: (The previous doc is here) src/network/kernel/qhostinfo.cpp:597: (qdoc) warning: clang found diagnostics parsing \fn QHostInfo(QHostInfo &&other) src/printsupport/dialogs/qabstractprintdialog.cpp:346: (qdoc) warning: clang found diagnostics parsing \fn int QAbstractPrintDialog::exec(): error: out-of-line definition of 'exec' does not match any declaration in 'QAbstractPrintDialog' src/testlib/qsignalspy.qdoc:101: (qdoc) warning: clang found diagnostics parsing \fn QSignalSpy(const QObject *obj, const QMetaMethod &signal): error: expected unqualified-id src/testlib/doc/src/qttest-best-practices.qdoc:28: (qdoc) warning: Can't link to 'Q_VERIFY2()' src/widgets/kernel/qactiongroup.cpp:291: (qdoc) warning: Undocumented parameter 'b' in QActionGroup::setExclusive() src/widgets/kernel/qactiongroup.cpp:305: (qdoc) warning: Undocumented return value (hint: use 'return' or 'returns' in the text src/widgets/kernel/qshortcut.cpp:542: (qdoc) warning: No such parameter 'context' in QShortcut::QShortcut() src/widgets/widgets/qdatetimeedit.cpp:632: (qdoc) warning: No such parameter 'minimumTime' in QDateTimeEdit::setTimeRange() src/widgets/widgets/qdatetimeedit.cpp:632: (qdoc) warning: No such parameter 'maximumTime' in QDateTimeEdit::setTimeRange() src/widgets/widgets/qdatetimeedit.cpp:632: (qdoc) warning: No such parameter 'less' in QDateTimeEdit::setTimeRange() Change-Id: I9799b5135e84c4d811674b2d114ef27315bc12df Reviewed-by: Paul Wicking <paul.wicking@qt.io>
This commit is contained in:
parent
c027d9b61e
commit
a6f56251ca
@ -109,7 +109,7 @@ QT_BEGIN_NAMESPACE
|
||||
/*!
|
||||
\internal
|
||||
\since 5.14
|
||||
bool qfloat16::isInf() const noexcept
|
||||
\fn bool qfloat16::isInf() const noexcept
|
||||
|
||||
Tests whether this \c qfloat16 value is an infinity.
|
||||
|
||||
@ -119,7 +119,7 @@ QT_BEGIN_NAMESPACE
|
||||
/*!
|
||||
\internal
|
||||
\since 5.14
|
||||
bool qfloat16::isNaN() const noexcept
|
||||
\fn bool qfloat16::isNaN() const noexcept
|
||||
|
||||
Tests whether this \c qfloat16 value is "not a number".
|
||||
|
||||
@ -128,7 +128,7 @@ QT_BEGIN_NAMESPACE
|
||||
|
||||
/*!
|
||||
\since 5.14
|
||||
bool qfloat16::isNormal() const noexcept
|
||||
\fn bool qfloat16::isNormal() const noexcept
|
||||
|
||||
Tests whether this \c qfloat16 value is finite and in normal form.
|
||||
|
||||
@ -138,7 +138,7 @@ QT_BEGIN_NAMESPACE
|
||||
/*!
|
||||
\internal
|
||||
\since 5.14
|
||||
bool qfloat16::isFinite() const noexcept
|
||||
\fn bool qfloat16::isFinite() const noexcept
|
||||
|
||||
Tests whether this \c qfloat16 value is finite.
|
||||
|
||||
|
@ -4612,7 +4612,7 @@ QDebug operator<<(QDebug dbg, const QObject *o)
|
||||
|
||||
It works exactly like the Q_NAMESPACE macro. However, the external
|
||||
\c{staticMetaObject} variable that gets defined in the namespace
|
||||
is declared with the supplied \c{EXPORT_MACRO} qualifier. This is
|
||||
is declared with the supplied \a EXPORT_MACRO qualifier. This is
|
||||
useful if the object needs to be exported from a dynamic library.
|
||||
|
||||
\sa Q_NAMESPACE, {Creating Shared Libraries}
|
||||
|
@ -1201,14 +1201,6 @@
|
||||
\sa toShort()
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QString QLocale::toString(ushort i) const
|
||||
|
||||
\overload
|
||||
|
||||
\sa toUShort()
|
||||
*/
|
||||
|
||||
/*!
|
||||
\fn QString QLocale::toString(int i) const
|
||||
|
||||
|
@ -2597,7 +2597,7 @@ uint qHash(long double key, uint seed) noexcept
|
||||
\sa operator=()
|
||||
*/
|
||||
|
||||
/*! \fn template <class Key, class T> template <class InputIterator> QMultiHash::QMultiHash(InputIterator begin, InputIterator end)
|
||||
/*! \fn template <class Key, class T> template <class InputIterator> QMultiHash<Key, T>::QMultiHash(InputIterator begin, InputIterator end)
|
||||
\since 5.14
|
||||
|
||||
Constructs a multi-hash with a copy of each of the elements in the iterator range
|
||||
|
@ -595,7 +595,7 @@ QHostInfo::QHostInfo(const QHostInfo &other)
|
||||
}
|
||||
|
||||
/*!
|
||||
\fn QHostInfo(QHostInfo &&other)
|
||||
\fn QHostInfo::QHostInfo(QHostInfo &&other)
|
||||
|
||||
Move-constructs a new QHostInfo from \a other.
|
||||
|
||||
|
@ -343,13 +343,6 @@ void QAbstractPrintDialogPrivate::setPrinter(QPrinter *newPrinter)
|
||||
pd = printer->d_func();
|
||||
}
|
||||
|
||||
/*!
|
||||
\fn int QAbstractPrintDialog::exec()
|
||||
|
||||
This virtual function is called to pop up the dialog. It must be
|
||||
reimplemented in subclasses.
|
||||
*/
|
||||
|
||||
/*!
|
||||
\class QPrintDialog
|
||||
|
||||
|
@ -243,7 +243,7 @@
|
||||
Instead of \c Q_ASSERT, the \l QCOMPARE() or \l QVERIFY() macro variants
|
||||
should be used. They cause the current test to report a failure and
|
||||
terminate, but allow the remaining test functions to be executed and the
|
||||
entire test program to terminate normally. \l Q_VERIFY2() even allows a
|
||||
entire test program to terminate normally. \l QVERIFY2() even allows a
|
||||
descriptive error message to be recorded in the test log.
|
||||
|
||||
\section1 Writing Reliable Tests
|
||||
|
@ -98,7 +98,7 @@
|
||||
\snippet code/doc_src_qsignalspy.cpp 6
|
||||
*/
|
||||
|
||||
/*! \fn QSignalSpy(const QObject *obj, const QMetaMethod &signal)
|
||||
/*! \fn QSignalSpy::QSignalSpy(const QObject *obj, const QMetaMethod &signal)
|
||||
\since 5.14
|
||||
|
||||
Constructs a new QSignalSpy that listens for emissions of the \a signal
|
||||
|
@ -292,7 +292,8 @@ QList<QAction*> QActionGroup::actions() const
|
||||
\brief Enable or disable the group exclusion checking
|
||||
|
||||
This is a convenience method that calls
|
||||
setExclusionPolicy(ExclusionPolicy::Exclusive).
|
||||
setExclusionPolicy(ExclusionPolicy::Exclusive) when \a b is true,
|
||||
else setExclusionPolicy(QActionGroup::ExclusionPolicy::None).
|
||||
|
||||
\sa QActionGroup::exclusionPolicy
|
||||
*/
|
||||
@ -303,7 +304,7 @@ void QActionGroup::setExclusive(bool b)
|
||||
}
|
||||
|
||||
/*!
|
||||
\brief Returs true if the group is exclusive
|
||||
\brief Returns true if the group is exclusive
|
||||
|
||||
The group is exclusive if the ExclusionPolicy is either Exclusive
|
||||
or ExclusionOptional.
|
||||
|
@ -475,7 +475,7 @@ QShortcut::QShortcut(QWidget *parent)
|
||||
match the \a key sequence. Depending on the ambiguity of the
|
||||
event, the shortcut will call the \a member function, or the \a
|
||||
ambiguousMember function, if the key press was in the shortcut's
|
||||
\a context.
|
||||
\a shortcutContext.
|
||||
*/
|
||||
QShortcut::QShortcut(const QKeySequence &key, QWidget *parent,
|
||||
const char *member, const char *ambiguousMember,
|
||||
|
@ -335,7 +335,6 @@ void QDateTimeEdit::setCalendar(QCalendar calendar)
|
||||
/*!
|
||||
\since 4.4
|
||||
\property QDateTimeEdit::minimumDateTime
|
||||
|
||||
\brief the minimum datetime of the date time edit
|
||||
|
||||
Changing this property implicitly updates the \l minimumDate and \l
|
||||
@ -637,8 +636,8 @@ void QDateTimeEdit::setDateRange(const QDate &min, const QDate &max)
|
||||
|
||||
Note that these only constrain the date time edit's value on,
|
||||
respectively, the \l minimumDate and \l maximumDate. When these date
|
||||
properties do not coincide, times after \a maximumTime are allowed on dates
|
||||
before \l maximumDate and times before \a minimumTime are allowed on dates
|
||||
properties do not coincide, times after \a max are allowed on dates
|
||||
before \l maximumDate and times before \a min are allowed on dates
|
||||
after \l minimumDate.
|
||||
|
||||
\snippet code/src_gui_widgets_qdatetimeedit.cpp 5
|
||||
@ -649,7 +648,7 @@ void QDateTimeEdit::setDateRange(const QDate &min, const QDate &max)
|
||||
|
||||
If either \a min or \a max is invalid, this function does nothing. This
|
||||
function preserves the \l minimumDate and \l maximumDate properties. If those
|
||||
properties coincide and max is \a less than \a min, \a min is used as \a max.
|
||||
properties coincide and \a max is less than \a min, \a min is used as \a max.
|
||||
|
||||
\sa minimumTime, maximumTime, setDateTimeRange(), QTime::isValid()
|
||||
*/
|
||||
|
Loading…
x
Reference in New Issue
Block a user