Описание javadoc-тега-style Doxygen, охватывающее несколько строк

В проекте C++ я использую doxygen и стиль javadoc для документации. Я довольно плохо знаком с javadoc и не уверен, допустим ли этот тип вещи.

/**
 * ...stuff...
 * @return foo foo foo foo foo. Foo foo
 * foo foo foo foo foo.
 */

т.е. информация для того, что возвращается (и мой вопрос относится ко всем тегам) должна покрыть несколько строк. Это автоматически обнаруживается, или я должен сделать что-то специальное?

Кроме того, от того, что я понимаю, у Вас может быть короткое описание класса и больше подробно описание класса. Как проблема выше, короткое описание класса может быть больше чем одной строкой? Если так, каков синтаксис для этого?

5
задан lotad 9 August 2010 в 01:35
поделиться