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.

        For Gerrit Dashboard: QTBUG-121378
        # Subject Branch Project Status CR V

            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