Комментарии в теле Doxygen

У меня есть код, который я хочу документировать с комментариями в теле, например:

/*! \file best.cpp
 *  \brief The best
 *
 *  I am the best
 */

/*! \fn void theBestFunction(int)
 * I'm the best blah blah blah
 */
void theBestFunction(int ever)
{
    doThings();
    /*!
     * Does some more things
     */
    doMoreThings();
    /*!
     * Checks that the things it does are the best
     */
    checkBest();
}

Но когда я запускаю doxygenпри этом кажется, что внутренние блоки форматируются в фрагменты кода, как если бы использовались команды @codeили \code(чего не было). Я хотел бы, чтобы комментарии в теле были отформатированы как обычный текст.

Кто-нибудь сталкивался с этим раньше? Спасибо.

8
задан Andrew Lee 25 June 2012 в 18:45
поделиться