From 6bc994f3fd272817d33beaacc7c5fd1398492e76 Mon Sep 17 00:00:00 2001 From: Martin Smith Date: Thu, 20 Jul 2017 12:36:53 +0200 Subject: [PATCH] doc: Correct all remaining clangqdoc warnings in qdebug.cpp MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This update corrects many qdoc warnings in qdebug.cpp caused by incomplete \fn commands. It also corrects many undocumented parameter errors caused by clang's requirement that the formal parameter names be the same in both the declaration in the include file and the \fn command. The name changes don't seem to be objectionable in this file. Change-Id: I0630a0e05e651b58608b2f2116df70dcf0e83a45 Reviewed-by: Topi Reiniƶ --- src/corelib/io/qdebug.cpp | 123 ++++++++++++++++++++------------------ 1 file changed, 64 insertions(+), 59 deletions(-) diff --git a/src/corelib/io/qdebug.cpp b/src/corelib/io/qdebug.cpp index 341400fd939..0d9a6c8749b 100644 --- a/src/corelib/io/qdebug.cpp +++ b/src/corelib/io/qdebug.cpp @@ -121,15 +121,15 @@ using QtMiscUtils::fromHex; */ /*! - \fn QDebug::QDebug(QtMsgType type) + \fn QDebug::QDebug(QtMsgType t) - Constructs a debug stream that writes to the handler for the message type specified by \a type. + Constructs a debug stream that writes to the handler for the message type \a t. */ /*! - \fn QDebug::QDebug(const QDebug &other) + \fn QDebug::QDebug(const QDebug &o) - Constructs a copy of the \a other debug stream. + Constructs a copy of the other debug stream \a o. */ /*! @@ -501,79 +501,79 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug &QDebug::operator<<(signed short i) + \fn QDebug &QDebug::operator<<(signed short t) - Writes the signed short integer, \a i, to the stream and returns a reference + Writes the signed short integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(unsigned short i) + \fn QDebug &QDebug::operator<<(unsigned short t) - Writes then unsigned short integer, \a i, to the stream and returns a + Writes then unsigned short integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(signed int i) + \fn QDebug &QDebug::operator<<(signed int t) - Writes the signed integer, \a i, to the stream and returns a reference + Writes the signed integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(unsigned int i) + \fn QDebug &QDebug::operator<<(unsigned int t) - Writes then unsigned integer, \a i, to the stream and returns a reference to + Writes then unsigned integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(signed long l) + \fn QDebug &QDebug::operator<<(signed long t) - Writes the signed long integer, \a l, to the stream and returns a reference + Writes the signed long integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(unsigned long l) + \fn QDebug &QDebug::operator<<(unsigned long t) - Writes then unsigned long integer, \a l, to the stream and returns a reference + Writes then unsigned long integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(qint64 i) + \fn QDebug &QDebug::operator<<(qint64 t) - Writes the signed 64-bit integer, \a i, to the stream and returns a reference + Writes the signed 64-bit integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(quint64 i) + \fn QDebug &QDebug::operator<<(quint64 t) - Writes then unsigned 64-bit integer, \a i, to the stream and returns a + Writes then unsigned 64-bit integer, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(float f) + \fn QDebug &QDebug::operator<<(float t) - Writes the 32-bit floating point number, \a f, to the stream and returns a + Writes the 32-bit floating point number, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(double f) + \fn QDebug &QDebug::operator<<(double t) - Writes the 64-bit floating point number, \a f, to the stream and returns a + Writes the 64-bit floating point number, \a t, to the stream and returns a reference to the stream. */ /*! - \fn QDebug &QDebug::operator<<(const char *s) + \fn QDebug &QDebug::operator<<(const char *t) - Writes the '\\0'-terminated string, \a s, to the stream and returns a + Writes the '\\0'-terminated string, \a t, to the stream and returns a reference to the stream. The string is never quoted nor transformed to the output, but note that some QDebug backends might not be 8-bit clean. */ @@ -595,9 +595,9 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug &QDebug::operator<<(const QString &s) + \fn QDebug &QDebug::operator<<(const QString &t) - Writes the string, \a s, to the stream and returns a reference to the + Writes the string, \a t, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\\u1234). @@ -634,9 +634,9 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug &QDebug::operator<<(const QStringRef &s) + \fn QDebug &QDebug::operator<<(const QStringRef &t) - Writes the string, \a s, to the stream and returns a reference to the + Writes the string, \a t, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\\u1234). @@ -663,9 +663,9 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug &QDebug::operator<<(QLatin1String s) + \fn QDebug &QDebug::operator<<(QLatin1String t) - Writes the string, \a s, to the stream and returns a reference to the + Writes the string, \a t, to the stream and returns a reference to the stream. Normally, QDebug prints the string inside quotes and transforms non-printable characters to their Unicode values (\\u1234). @@ -677,9 +677,9 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug &QDebug::operator<<(const QByteArray &b) + \fn QDebug &QDebug::operator<<(const QByteArray &t) - Writes the byte array, \a b, to the stream and returns a reference to the + Writes the byte array, \a t, to the stream and returns a reference to the stream. Normally, QDebug prints the array inside quotes and transforms control or non-US-ASCII characters to their C escape sequences (\\xAB). This way, the output is always 7-bit clean and the string can be copied from the @@ -716,9 +716,9 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug &QDebug::operator<<(const void *p) + \fn QDebug &QDebug::operator<<(const void *t) - Writes a pointer, \a p, to the stream and returns a reference to the stream. + Writes a pointer, \a t, to the stream and returns a reference to the stream. */ /*! @@ -732,99 +732,99 @@ QDebug &QDebug::resetFormat() */ /*! - \fn QDebug operator<<(QDebug stream, const QList &list) + \fn template QDebug operator<<(QDebug debug, const QList &list) \relates QDebug - Writes the contents of \a list to \a stream. \c T needs to + Writes the contents of \a list to \a debug. \c T needs to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const std::list &list) + \fn template QDebug operator<<(QDebug debug, const std::list &vec) \relates QDebug \since 5.7 - Writes the contents of \a list to \a stream. \c T needs to + Writes the contents of list \a vec to \a debug. \c T needs to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const QVector &vector) + \fn template QDebug operator<<(QDebug debug, const QVector &vec) \relates QDebug - Writes the contents of \a vector to \a stream. \c T needs to + Writes the contents of vector \a vec to \a debug. \c T needs to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const std::vector &vector) + \fn template QDebug operator<<(QDebug debug, const std::vector &vec) \relates QDebug \since 5.7 - Writes the contents of \a vector to \a stream. \c T needs to + Writes the contents of vector \a vec to \a debug. \c T needs to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const QSet &set) + \fn template QDebug operator<<(QDebug debug, const QSet &set) \relates QDebug - Writes the contents of \a set to \a stream. \c T needs to + Writes the contents of \a set to \a debug. \c T needs to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const QMap &map) + \fn template QDebug operator<<(QDebug debug, const QMap &map) \relates QDebug - Writes the contents of \a map to \a stream. Both \c Key and + Writes the contents of \a map to \a debug. Both \c Key and \c T need to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const std::map &map) + \fn template QDebug operator<<(QDebug debug, const std::map &map) \relates QDebug \since 5.7 - Writes the contents of \a map to \a stream. Both \c Key and + Writes the contents of \a map to \a debug. Both \c Key and \c T need to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const std::multimap &map) + \fn template QDebug operator<<(QDebug debug, const std::multimap &map) \relates QDebug \since 5.7 - Writes the contents of \a map to \a stream. Both \c Key and + Writes the contents of \a map to \a debug. Both \c Key and \c T need to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const QHash &hash) + \fn template QDebug operator<<(QDebug debug, const QHash &hash) \relates QDebug - Writes the contents of \a hash to \a stream. Both \c Key and + Writes the contents of \a hash to \a debug. Both \c Key and \c T need to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const QPair &pair) + \fn template QDebug operator<<(QDebug debug, const QPair &pair) \relates QDebug - Writes the contents of \a pair to \a stream. Both \c T1 and + Writes the contents of \a pair to \a debug. Both \c T1 and \c T2 need to support streaming into QDebug. */ /*! - \fn QDebug operator<<(QDebug stream, const QFlags &flag) + \fn template QDebug operator<<(QDebug debug, const QFlags &flags) \relates QDebug \since 4.7 - Writes \a flag to \a stream. + Writes \a flags to \a debug. */ /*! - \fn QDebug operator<<(QDebug debug, const QSharedPointer &ptr) + \fn template QDebug operator<<(QDebug debug, const QSharedPointer &ptr) \relates QSharedPointer \since 5.7 @@ -834,6 +834,11 @@ QDebug &QDebug::resetFormat() \sa {Debugging Techniques} */ +/*! + \fn QDebug &QDebug::operator<<(std::nullptr_t) + \internal + */ + /*! \class QDebugStateSaver \inmodule QtCore