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

qdoc: Improve handling of errors during \fn signature parsing

XMLWordPrintable

    • Icon: Task Task
    • Resolution: Fixed
    • Icon: P2: Important P2: Important
    • 6.8.0 FF
    • 6.8
    • Build tools: qdoc
    • None

      Recent changes to QDoc (in dev) caused multiple superfluous warnings to be generated. These are of type

      qt5/qtbase/src/network/access/qhttp2connection.cpp:46: (qdoc) warning: clang couldn't find function when parsing \fn quint32 QHttp2Stream::streamID() const noexcept
      

      These are for \fn documentation blocks that are members of \class or \namespace entries that are marked \internal. Therefore, they do not affect the validity of the output, but still have an impact for testing doc generation in CI where we enforce no warnings.

      The reason is that the order of parsing topic- and meta-commands have changed, and therefore the Clang code parser has no longer information available about meta-commands (specifically, \internal) assigned to the base class when parsing an \fn.

      These errors must be stored for later processing, so that a subclass of them can be safely omitted in above cases.

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

            treinio Topi Reiniƶ
            treinio Topi Reiniƶ
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:

                There are no open Gerrit changes