1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: Show more examples on how to have multiple logging rules

Browse Source 
Task-number: QTBUG-66050
Change-Id: I6872cd64f9b27b9849e4166af7aa6414c372cd5e
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: hjk <hjk@qt.io>
This commit is contained in:
Kai Koehne 2018-01-30 14:52:14 +01:00
parent b1bbce2609
commit 7917305aa5
1 changed files with 16 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
src/corelib/io/qloggingcategory.cpp
View File

@ -147,9 +147,15 @@ static void setBoolLane(QBasicAtomicInt *atomic, bool enable, int shift)
Rules are evaluated in text order, from first to last. That is, if two rules Rules are evaluated in text order, from first to last. That is, if two rules
apply to a category/type, the rule that comes later is applied. apply to a category/type, the rule that comes later is applied.
Rules can be set via \l setFilterRules(). Since Qt 5.3, logging rules can also Rules can be set via \l setFilterRules():
be set in the \c QT_LOGGING_RULES environment variable, and
are automatically loaded from the \c [Rules] section of a logging \code
QLoggingCategory::setFilterRules("*.debug=false\n"
"driver.usb.debug=true");
\endcode
Since Qt 5.3, logging rules are also
automatically loaded from the \c [Rules] section of a logging
configuration file. Such configuration files are looked up in the QtProject configuration file. Such configuration files are looked up in the QtProject
configuration directory, or explicitly set in a \c QT_LOGGING_CONF configuration directory, or explicitly set in a \c QT_LOGGING_CONF
environment variable: environment variable:
@ -160,19 +166,18 @@ static void setBoolLane(QBasicAtomicInt *atomic, bool enable, int shift)
driver.usb.debug=true driver.usb.debug=true
\endcode \endcode
Rules set by \l setFilterRules() take precedence over rules specified Since Qt 5.3, logging rules can also be specified in a \c QT_LOGGING_RULES
in the QtProject configuration directory, and can, in turn, be environment variable. And since Qt 5.6, multiple rules can also be
overwritten by rules from the configuration file specified by separated by semicolons:
\c QT_LOGGING_CONF, and rules set by \c QT_LOGGING_RULES.
Since Qt 5.6, \c QT_LOGGING_RULES may contain multiple rules separated
by semicolons:
\code \code
QT_LOGGING_RULES="*.debug=false;driver.usb.debug=true" QT_LOGGING_RULES="*.debug=false;driver.usb.debug=true"
\endcode \endcode
Rules set by \l setFilterRules() take precedence over rules specified
in the QtProject configuration directory, and can, in turn, be
overwritten by rules from the configuration file specified by
\c QT_LOGGING_CONF, and rules set by \c QT_LOGGING_RULES.
Order of evaluation: Order of evaluation:
\list \list