Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-66050

wrong separator in doc of QLoggingCategory

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • P2: Important
    • 5.11.1
    • 5.9.0, 5.10.0
    • Documentation
    • None
    • 7917305aa5acdad117632bc2723d9bec85daa0e0

    Description

      http://doc.qt.io/qt-5/qloggingcategory.html, section "Configuring Categories", subsection "Logging Rules" gives this example:
      QT_LOGGING_RULES="*.debug=false;driver.usb.debug=true"

      Besides QT_LOGGING_RULES, the subsection enumerates four other methods of setting the rules, among them setFilterRules(). The documentation of this function does not explain how to set multiple rules. Hence the user can do no better than extrapolate that the syntax of QT_LOGGING_RULES also holds for setFilterRules().

      However, this is not the case. From the Qt5.9 source code it is clear, and experimentation confirms, that the separator in setFilterRules() must be a newline (\n), not a semicolon. This ought to be documented somewhere.

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            kkohne Kai Köhne
            jwu Joachim Wuttke
            Votes:
            1 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes