/**************************************************************************//**
* some comments
*****************************************************************************/
/*****************************************************************************
* some comments
*****************************************************************************/
Насколько я понимаю, для обработки doxygen требуются специальные комментарии (см.: Документирование кода). Но у него также есть возможность включить JAVADOC_BLOCK в doxyfile. Зачем жертвовать эстетикой кода, если в этом нет необходимости?
Я часто вижу: [code]/**************************************************************************//** * some comments *****************************************************************************/ [/code] Почему бы и нет: [code]/***************************************************************************** * some comments *****************************************************************************/ [/code] Насколько я понимаю, для обработки doxygen требуются специальные комментарии (см.: Документирование кода). Но у него также есть возможность включить JAVADOC_BLOCK в doxyfile. Зачем жертвовать эстетикой кода, если в этом нет необходимости?