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

QDoc: Implement COMMAND_COMPARES

    XMLWordPrintable

Details

    • Task
    • Resolution: Fixed
    • P2: Important
    • 6.7.0 FF
    • None
    • Build tools: qdoc
    • None
    • 575e9c7fa (dev)
    • DaVinci89, DaVinci 90, DaVinci 91

    Description

      This is an implementation task resulted from QTBUG-104110.

      In summary;

      Introduce a new command, `\compares`, to QDoc. The command shall take two arguments
      1) the comparison category that applies to the result of comparing the type being documented with the type(s) in the second argument. This argument shall be one of the following:

        `strong`
        `partial`
        `weak`
        `equality`

      2) A list of types this type can compare to with the comparison category given in the first argument.

      QDoc shall generate a statement as part of the type's documentation, e.g:

          `This type compares strongly with QFoo, QBar, and QBaz.`

      Multiple occurrences of the command must be permissible, to allow e.g. documenting that a type T compares strongly with type Y, and also that type T compares weakly with type Z.

      Attachments

        Issue Links

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

          Activity

            People

              treinio Topi Reiniö
              paulwicking Paul Wicking
              Tino Pyssysalo Tino Pyssysalo
              Topi Reiniö Topi Reiniö
              Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There are no open Gerrit changes