Doc: link from non-categorized logging API to QLoggingCategory

The <QtLogging> documentation page is easily found, and from there it's
not easy to see that categorized logging is a feature. Add more links.

Pick-to: 6.8
Task-number: QTBUG-125589
Change-Id: I214b9a561d6fc6b4c8600bc1b1eca04d856678d6
Reviewed-by: Safiyyah Moosa <safiyyah.moosa@qt.io>
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
This commit is contained in:
Volker Hilsheimer 2024-07-16 11:57:58 +02:00
parent fb5e143305
commit 7c344176d2

View File

@ -162,6 +162,8 @@ Q_TRACE_POINT(qtcore, qt_message_print, int type, const char *category, const ch
Example: Example:
\snippet code/src_corelib_global_qglobal.cpp 4 \snippet code/src_corelib_global_qglobal.cpp 4
\sa QLoggingCategory
*/ */
template <typename String> template <typename String>
@ -423,6 +425,8 @@ void QMessageLogger::info(const char *msg, ...) const
with this signature, and \c Q_LOGGING_CATEGORY generates its definition. with this signature, and \c Q_LOGGING_CATEGORY generates its definition.
\since 5.3 \since 5.3
\sa QLoggingCategory
*/ */
/*! /*!
@ -2399,6 +2403,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
Constructs a QMessageLogger to record \a category messages for \a file at \a line Constructs a QMessageLogger to record \a category messages for \a file at \a line
in \a function. in \a function.
\sa QLoggingCategory
*/ */
/*! /*!
@ -2423,6 +2429,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
Constructs a QMessageLogContext with for file \a fileName at line Constructs a QMessageLogContext with for file \a fileName at line
\a lineNumber, in function \a functionName, and category \a categoryName. \a lineNumber, in function \a functionName, and category \a categoryName.
\sa QLoggingCategory
*/ */
/*! /*!
@ -2458,8 +2466,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
To suppress the output at runtime, install your own message handler To suppress the output at runtime, install your own message handler
with qInstallMessageHandler(). with qInstallMessageHandler().
\sa qInfo(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler(), \sa qCDebug(), qInfo(), qWarning(), qCritical(), qFatal(),
{Debugging Techniques} qInstallMessageHandler(), {Debugging Techniques}
*/ */
/*! /*!
@ -2496,8 +2504,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
To suppress the output at runtime, install your own message handler To suppress the output at runtime, install your own message handler
using qInstallMessageHandler(). using qInstallMessageHandler().
\sa qDebug(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler(), \sa qCInfo(), qDebug(), qWarning(), qCritical(), qFatal(),
{Debugging Techniques} qInstallMessageHandler(), {Debugging Techniques}
*/ */
/*! /*!
@ -2540,8 +2548,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
on the first call; if it contains the value 10, it will exit on the 10th on the first call; if it contains the value 10, it will exit on the 10th
call. Any non-numeric value in the environment variable is equivalent to 1. call. Any non-numeric value in the environment variable is equivalent to 1.
\sa qDebug(), qInfo(), qCritical(), qFatal(), qInstallMessageHandler(), \sa qCWarning(), qDebug(), qInfo(), qCritical(), qFatal(),
{Debugging Techniques} qInstallMessageHandler(), {Debugging Techniques}
*/ */
/*! /*!
@ -2583,8 +2591,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
on the first call; if it contains the value 10, it will exit on the 10th on the first call; if it contains the value 10, it will exit on the 10th
call. Any non-numeric value in the environment variable is equivalent to 1. call. Any non-numeric value in the environment variable is equivalent to 1.
\sa qDebug(), qInfo(), qWarning(), qFatal(), qInstallMessageHandler(), \sa qCCritical(), qDebug(), qInfo(), qWarning(), qFatal(),
{Debugging Techniques} qInstallMessageHandler(), {Debugging Techniques}
*/ */
/*! /*!
@ -2610,8 +2618,8 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
To suppress the output at runtime, install your own message handler To suppress the output at runtime, install your own message handler
with qInstallMessageHandler(). with qInstallMessageHandler().
\sa qDebug(), qInfo(), qWarning(), qCritical(), qInstallMessageHandler(), \sa qCFatal(), qDebug(), qInfo(), qWarning(), qCritical(),
{Debugging Techniques} qInstallMessageHandler(), {Debugging Techniques}
*/ */
/*! /*!
@ -2635,7 +2643,7 @@ QMessageLogContext &QMessageLogContext::copyContextFrom(const QMessageLogContext
A message generated by the qFatal() function. A message generated by the qFatal() function.
\omitvalue QtSystemMsg \omitvalue QtSystemMsg
\sa QtMessageHandler, qInstallMessageHandler() \sa QtMessageHandler, qInstallMessageHandler(), QLoggingCategory
*/ */
QT_END_NAMESPACE QT_END_NAMESPACE