У меня есть код, который я хочу документировать с комментариями в теле, например:
/*! \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
(чего не было). Я хотел бы, чтобы комментарии в теле были отформатированы как обычный текст.
Кто-нибудь сталкивался с этим раньше? Спасибо.