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

As a user of qdoc, I want to use multiple \macro/\typedef/etc in a single block, not just \fn

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • P3: Somewhat important
    • None
    • dev
    • Build tools: qdoc
    • None

    Description

      Attached file is the result of the following code comment block:

      /*!
          \macro Q_INT128_MIN
          \macro Q_INT128_MAX
          \macro Q_UINT128_MAX
          \relates <QtTypes>
          \since 6.6
      
          These macros each expand to a compile-time constant representing the
          minimum (\c{_MIN}) or maximum (\c{_MAX}) value representable in a qint128
          (\c{Q_INT128_}) or a quint128 (\c{Q_UINT128_}). The minimum of quint128 is
          0 (zero), so a \c{Q_UINT128_MIN} is neither needed nor provided.
          These macros are available in both C++ and C modes.
      
          \sa qint128, quint128, Q_INT128_C, Q_UINT128_C, QT_SUPPORTS_INT128
      */
      

      from https://codereview.qt-project.org/c/qt/qtbase/+/503004/5 (PS5, I will probably have fixed it by PS6).

      Note how only the \since made it into the final documentation and how the documentation blocks are separated from each other and not combined.

      Attachments

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

        Activity

          People

            docinfrastructure Documentation Infrastructure Team
            mmutz Marc Mutz
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes