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

QDoc: Allow documentation to exist in header files

    XMLWordPrintable

Details

    • User Story
    • Resolution: Unresolved
    • P2: Important
    • None
    • None
    • Build tools: qdoc
    • None

    Description

      As a developer, I want to write the documentation for my API in the header file where I declare it.

      Background: In Qt, documentation is contained in implementation files and .qdoc files. Other projects keep documentation comments in header files. This was raised as an obstacle in using QDoc for generating documentation for other projects during the Qt Contributor's Summit 2021.

      Attachments

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

        Activity

          People

            docinfrastructure Documentation Infrastructure Team
            paulwicking Paul Wicking
            Tino Pyssysalo Tino Pyssysalo
            Paul Wicking Paul Wicking
            Votes:
            2 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes