Как в textmate делать комментарии в стиле javadoc, как в eclipse?
В eclipse, когда я хочу задокументировать функцию (в исходном коде java или javascript), я могу просто ввести / **, затем нажать Enter, и я получаю такой комментарий
/**
*
* Fluctuates all variables to more compatibly foo all the bars
*
* @PARAM {int} foo
*/
function flucvar (foo) {
}
При нажатии Enter внутри комментария eclipse автоматически добавляет дополнительный * в начале каждой строки.
Теперь я просто вхожу в свой паз с textmate и обнаруживаю, что мне не хватает этой небольшой функциональности. Есть ли эквивалентный пакет или команда или что-то, что позволило бы мне создавать аналогичные комментарии в textmate?
Ответы 3
Я взглянул на пакет Java от TextMate и ничего не увидел о вставке комментариев JavaDoc. Однако добавить такую функцию в пакет Java не должно быть так уж сложно. Скорее всего, это будет сниппет, о котором вы можете прочитать в главе 7 руководства по TextMate (доступ к нему осуществляется с Help -> TextMate Help).
спасибо за этот ответ. Я только что нашел этот пост на сайте макроматов
http://blog.macromates.com/2006/customization-screencast/
похоже, у этого есть видео / сообщение в списке рассылки, в котором подробно объясняется, как это сделать.
Вам нужно создать два сниппета (у меня они есть в пакете Source).
Сначала создайте фрагмент для вставки комментариев JavaDoc. Фрагмент содержит следующее:
/**
* $0
*/
У меня для активации фрагмента установлено значение Tab Trigger, используя /** в качестве строки активации. Каждый раз, когда я пишу /** и нажимаю Tab, я получаю блок комментариев JavaDoc. Вы также можете использовать сочетание клавиш, если хотите.
Второй фрагмент предназначен для продолжения существующих комментариев JavaDoc. Содержимое фрагмента:
* $0
Обратите внимание, что перед строкой * $0 есть пустая строка. Установите для активации значение Ключевой эквивалент, а для ключа запуска - значение возвращаться. Установите для строки Селектор области видимости значение comment.documentation.
Теперь, если ваш языковой пакет поддерживает область comment.documentation (как, кажется, все включенные пакеты), у вас должны быть рабочие ярлыки для комментариев JavaDoc.
Чтобы заставить эту работу работать с javascript, мне пришлось установить для выбора области действия значение «comment.block.documentation».
Мне пришлось установить Селектор области видимости на comment.block.js, чтобы он работал в JavaScript (Textmate 2)
Ясно, что это должен быть комментарий, но я считаю, что на самом деле он не заслуживает -1, так как это указывает на хороший ресурс!