Я ни с чем не могу говорить кроме SQL Server, но аргумент производительности не значительно допустим там, если Вы не находитесь на 6,5 или ранее. SQL Server кэшировал специальные планы выполнения примерно в течение десятилетия теперь.
Для меня / **
или Shift - Alt - J ( или ⌘ - ⌥ - J на Mac) лучше всего работает.
Мне не нравится видеть комментарии Javadoc в исходном коде, которые были созданы автоматически и не были обновлены реальным содержанием. Насколько я понимаю, такие javadocs - не более чем пустая трата места на экране.
IMO, гораздо лучше генерировать скелеты комментариев Javadoc один за другим, поскольку вы собираетесь заполнить детали.
Shift-Alt-J
- удобное сочетание клавиш в Eclipse для создания шаблонов комментариев Javadoc.
Вызов ярлыка в объявлении класса, метода или поля создаст шаблон Javadoc:
public int doAction(int i) {
return i;
}
Нажатие Shift-Alt-J
в объявлении метода дает:
/**
* @param i
* @return
*/
public int doAction(int i) {
return i;
}
JAutoDoc :
и Eclipse Плагин для автоматического добавления Javadoc и заголовков файлов в исходный код. При желании он генерирует начальные комментарии из имени элемента с помощью Velocity шаблонов для Javadoc и заголовков файлов ...
В том месте, где вы хотите javadoc, введите / **