В проекте C++ я использую doxygen и стиль javadoc для документации. Я довольно плохо знаком с javadoc и не уверен, допустим ли этот тип вещи.
/**
* ...stuff...
* @return foo foo foo foo foo. Foo foo
* foo foo foo foo foo.
*/
т.е. информация для того, что возвращается (и мой вопрос относится ко всем тегам) должна покрыть несколько строк. Это автоматически обнаруживается, или я должен сделать что-то специальное?
Кроме того, от того, что я понимаю, у Вас может быть короткое описание класса и больше подробно описание класса. Как проблема выше, короткое описание класса может быть больше чем одной строкой? Если так, каков синтаксис для этого?