Плагин doxygen eclipse автоматически генерирует документацию о заглушке?
Я ищу плагин eclipse для документации по кислородному коду. Я нашел eclox-plugIn (http://home.gna.org/eclox/). Я хотел бы узнать, как он может автоматически генерировать "пустой" комментарий doxygen, который может быть заполнен позже или что является лучшим выбором для документации eclipse plugin?
Например, для функции: void f (int p1, int p2,...), она должна генерировать:
/*! \brief ...
\param p1 ...
..
*/
PS
Я использую в основном языки c/С++
Ответы
Ответ 1
См. обновленное решение.
Старый ответ:
В настройках eclipse helios в окне- > настройки вы можете:
c/С++ → Code Style- > Code Templates- > Комментарии
+
Автоматически добавлять комментарии для новых методов и классов
Здесь вы можете настроить стиль комментариев, но он не такой умный, как должен быть. Если вы найдете что-то лучшее, я буду очень рад...
Ответ 2
Другой (лучший) подход, чем мой предыдущий ответ:
В Window- > Preferences- > C/С++ → Редактор,
В правой вкладке найдите "Комментарии к инструменту документации", а в "Рабочий стол по умолчанию" установите doxygen
.
Теперь вы можете набрать /**
над функцией и нажать return.
/**
int foo(int bar);
становится
/**
*
* @param bar
* @return
*/
int foo(int bar);
Ответ 3
Для конкретных настроек проекта
В Project- > Properties- > C/С++ Общие сведения:
- Tick Включить специальные настройки проекта
- Выберите Doxygen как инструмент документации
Тогда набрав /**
над функцией /method и нажав enter, будет работать. См. здесь.