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

Ignore \deprecated [x.y] if x.y is a future version

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P2: Important P2: Important
    • 6.8.0 FF
    • 6.8
    • Build tools: qdoc
    • None
    • 0532419f7 (dev)
    • DaVinci 94

      When \deprecate is used for future Qt version, qdoc should ignore the deprecation command.

      Example: https://doc-snapshots.qt.io/qt6-dev/qcheckbox-obsolete.html#stateChanged

      Despite what the documentation says, this method is not deprecated just yet (in Qt 6.7, Qt 6.8). It will be in Qt 6.9, though:

      /*!
          \fn void QCheckBox::stateChanged(int state)
      
          \deprecated [6.9] Use checkStateChanged(Qt::CheckState) instead.
      */
      

      In this case, it would be arguably better that Qdoc compares the version in the brackets to the current Qt version, and ignores the command for Qt 6.7, 6.8.

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

            treinio Topi Reiniö
            kkohne Kai Köhne
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:

                There are no open Gerrit changes