From 739e7dd1912b1828bd568fd50c0dffaa6550b80a Mon Sep 17 00:00:00 2001 From: Topi Reinio Date: Thu, 29 Oct 2020 18:11:22 +0100 Subject: Doc: Fix various documentation issues for Qt Core Task-number: QTBUG-86295 Change-Id: I3bf7d4b1533d4fc81114d353b19beaf4ea9b93b2 Reviewed-by: Volker Hilsheimer Reviewed-by: Paul Wicking --- src/corelib/kernel/qdeadlinetimer.cpp | 5 ++--- src/corelib/kernel/qmetaobject.cpp | 4 ++-- src/corelib/kernel/qmetatype.cpp | 4 ++-- src/corelib/kernel/qmimedata.cpp | 2 +- src/corelib/kernel/qobject.cpp | 5 ++--- src/corelib/kernel/qobjectdefs.h | 4 ++-- src/corelib/kernel/qproperty.cpp | 4 ++-- 7 files changed, 13 insertions(+), 15 deletions(-) (limited to 'src/corelib/kernel') diff --git a/src/corelib/kernel/qdeadlinetimer.cpp b/src/corelib/kernel/qdeadlinetimer.cpp index 0fcfffd98f..a225713ce0 100644 --- a/src/corelib/kernel/qdeadlinetimer.cpp +++ b/src/corelib/kernel/qdeadlinetimer.cpp @@ -873,7 +873,7 @@ QDeadlineTimer QDeadlineTimer::addNSecs(QDeadlineTimer dt, qint64 nsecs) noexcep */ /*! - \fn bool QDeadlineTimer::operator==(QDeadlineTimer d1, QDeadlineTimer::QDeadlineTimer d2) + \fn bool QDeadlineTimer::operator==(QDeadlineTimer d1, QDeadlineTimer d2) Returns true if the deadline on \a d1 and the deadline in \a d2 are the same, false otherwise. The timer type used to create the two deadlines is @@ -951,8 +951,7 @@ QDeadlineTimer QDeadlineTimer::addNSecs(QDeadlineTimer dt, qint64 nsecs) noexcep */ /*! - \fn QDeadlineTimer operator+(QDeadlineTimer dt, qint64 msecs) - \relates QDeadlineTimer + \fn QDeadlineTimer QDeadlineTimer::operator+(QDeadlineTimer dt, qint64 msecs) Returns a QDeadlineTimer object whose deadline is \a msecs later than the deadline stored in \a dt. If \a dt is set to never expire, this function diff --git a/src/corelib/kernel/qmetaobject.cpp b/src/corelib/kernel/qmetaobject.cpp index 6b6e2b0912..baf7ce81ec 100644 --- a/src/corelib/kernel/qmetaobject.cpp +++ b/src/corelib/kernel/qmetaobject.cpp @@ -2943,7 +2943,7 @@ const char *QMetaProperty::typeName() const Returns this property's type. The return value is one of the values of the QVariant::Type enumeration. - \sa metaType().id(), typeName(), name(), metaType() + \sa typeName(), name(), metaType() */ /*! \fn int QMetaProperty::userType() const @@ -3248,7 +3248,7 @@ bool QMetaProperty::reset(QObject *object) const If the property doesn't support bindings, the returned interface will be invalid. - \sa QUntypedBindable, QProperty, isBindable() + \sa QObjectBindableProperty, QProperty, isBindable() */ QUntypedBindable QMetaProperty::bindable(QObject *object) const { diff --git a/src/corelib/kernel/qmetatype.cpp b/src/corelib/kernel/qmetatype.cpp index be76a3f1d9..d4ab51d323 100644 --- a/src/corelib/kernel/qmetatype.cpp +++ b/src/corelib/kernel/qmetatype.cpp @@ -409,7 +409,7 @@ Q_GLOBAL_STATIC(QMetaTypeCustomRegistry, customTypeRegistry) \value NeedsConstruction This type has non-trivial constructors. If the flag is not set instances can be safely initialized with memset to 0. \value NeedsDestruction This type has a non-trivial destructor. If the flag is not set calls to the destructor are not necessary before discarding objects. - \value ReloctableType An instance of a type having this attribute can be safely moved to a different memory location using memcpy. + \value RelocatableType An instance of a type having this attribute can be safely moved to a different memory location using memcpy. \omitvalue MovableType \omitvalue SharedPointerToQObject \value IsEnumeration This type is an enumeration. @@ -2580,7 +2580,7 @@ Q_CORE_EXPORT int qMetaTypeTypeInternal(const char *typeName) } /*! - \fn int QMetaType::type(const QByteArray &typeName) + \fn int QMetaType::type(const QT_PREPEND_NAMESPACE(QByteArray) &typeName) \since 5.5 \overload diff --git a/src/corelib/kernel/qmimedata.cpp b/src/corelib/kernel/qmimedata.cpp index a370639a64..d99874bd67 100644 --- a/src/corelib/kernel/qmimedata.cpp +++ b/src/corelib/kernel/qmimedata.cpp @@ -320,7 +320,7 @@ QT_WARNING_POP QMacPasteboardMime maps MIME to Mac flavors. \sa QClipboard, QDragEnterEvent, QDragMoveEvent, QDropEvent, QDrag, - QMacPasteboardMime, {Drag and Drop} + {Drag and Drop} */ /*! diff --git a/src/corelib/kernel/qobject.cpp b/src/corelib/kernel/qobject.cpp index fc46ab84f8..f3fd249d09 100644 --- a/src/corelib/kernel/qobject.cpp +++ b/src/corelib/kernel/qobject.cpp @@ -4217,8 +4217,8 @@ QDebug operator<<(QDebug dbg, const QObject *o) \relates QObject This macro associates extra information to the class, which is available - using QObject::metaObject(). Qt makes only limited use of this feature, in - the \l{Active Qt}, \l{Qt D-Bus} and \l{Qt QML module}{Qt QML}. + using QObject::metaObject(). Qt makes only limited use of this feature in + \l{Qt D-Bus} and \l{Qt QML module}{Qt QML}. The extra information takes the form of a \a Name string and a \a Value literal string. @@ -4228,7 +4228,6 @@ QDebug operator<<(QDebug dbg, const QObject *o) \snippet code/src_corelib_kernel_qobject.cpp 35 \sa QMetaObject::classInfo() - \sa QAxFactory \sa {Using Qt D-Bus Adaptors} \sa {Extending QML} */ diff --git a/src/corelib/kernel/qobjectdefs.h b/src/corelib/kernel/qobjectdefs.h index 2c1415f7b6..5ade222ac5 100644 --- a/src/corelib/kernel/qobjectdefs.h +++ b/src/corelib/kernel/qobjectdefs.h @@ -459,9 +459,9 @@ public: operator RestrictedBool() const { return d_ptr && isConnected_helper() ? &Connection::d_ptr : nullptr; } #endif - Connection(Connection &&o) noexcept : d_ptr(qExchange(o.d_ptr, nullptr)) {} + Connection(Connection &&other) noexcept : d_ptr(qExchange(other.d_ptr, nullptr)) {} QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_PURE_SWAP(Connection) - void swap(Connection &o) noexcept { qSwap(d_ptr, o.d_ptr); } + void swap(Connection &other) noexcept { qSwap(d_ptr, other.d_ptr); } }; inline void swap(QMetaObject::Connection &lhs, QMetaObject::Connection &rhs) noexcept diff --git a/src/corelib/kernel/qproperty.cpp b/src/corelib/kernel/qproperty.cpp index e4f12500a3..b55069d1ae 100644 --- a/src/corelib/kernel/qproperty.cpp +++ b/src/corelib/kernel/qproperty.cpp @@ -1038,7 +1038,7 @@ QString QPropertyBindingError::description() const expression and returns the previously associated binding. The first time the property value is read, the binding is evaluated. Whenever a dependency of the binding changes, the binding will be re-evaluated the next time the value of - this property is read. When the property value changes \a owner is notified + this property is read. When the property value changes, the owner is notified via the Callback function. */ @@ -1051,7 +1051,7 @@ QString QPropertyBindingError::description() const is read, the binding is evaluated by invoking the call operator () of \a f. Whenever a dependency of the binding changes, the binding will be re-evaluated the next time the value of this property is read. When the property value - changes \a owner is notified via the Callback function. + changes, the owner is notified via the Callback function. */ /*! -- cgit v1.2.3