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

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

    XMLWordPrintable

Details

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

    Description

      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.

      Attachments

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

        Activity

          People

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

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes