Important: Please read the Qt Code of Conduct -

Different Comment Styles [solved]

  • Hi,

    I started to document my code using Doxygen. Doxygens manual says there are two different ways to mark a commentblock to be documentated. One started with //* (JavaDoc style), the other with //! (Qt style).
    If I type //* above my setReal-Method of my CplxNum-Class in Qt-Creator it will be auto-completed to


    • @brief CplxNum::setReal
    • @param real

    and //! is autocompleted to


    • \brief CplxNum::setReal
    • \param real

    I noticed that there is a minor different in these completions (@param -> \param, @brief -> \brief). I guess that this is a Qt specific thing, because it doesn't know that I want to use Doxygen for documentation.

    What is the difference between these two comment styles and which one is recommended?


  • Moderators


    The differences are purely cosmetic. Doxygen accepts both JavaDoc-style and Qt-style comments, so you can choose whichever you want.

    In fact, Doxygen began as a tool to generate documentation for Qt code:

  • Hi JKSH,

    thanks for your reply. Good to know that there is no difference between these styles.

    -> solved

Log in to reply