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

Omit templates on own class template names

    XMLWordPrintable

Details

    • Suggestion
    • Resolution: Unresolved
    • P3: Somewhat important
    • None
    • None
    • Build tools: qdoc
    • None

    Description

      Example:  https://doc.qt.io/qt-6/qspan.html#QSpan-2 (in case the docs got updated in the meantime: this is the QSpan move ctor) should be rendered like this:

      QSpan::QSpan(QSpan &&other);
      

      not, like currently

      QSpan::QSpan(QSpan<T, E> &&other);
      

      Rationale: cleaner, because shorter and less confusing (the class template arguments are shown only once, in small print, at the top of the page), esp. compared to the constructor from a differently-sized span, https://doc.qt.io/qt-6/qspan.html#QSpan-1: The listing atm shows

      QSpan(QSpan<S,N>);
      QSpan(QSpan<T,E> &&);
      QSpan(const QSpan<T,E> &);
      

      which is confusing, compared to

      QSpan(QSpan<S,N>);
      QSpan(QSpan &&);
      QSpan(const QSpan &);
      

      Attachments

        Issue Links

          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