В textmate, как сделать комментарии в стиле Javadoc, как я могу в затмении? - PullRequest
2 голосов
/ 03 января 2009

В eclipse, когда я хочу задокументировать функцию (в исходном коде java или javascript), я могу просто набрать / **, затем нажать Enter, и я получаю комментарий, подобный этому

 /**
 *
 * Fluctuates all variables to more compatibly foo all the bars
 *
 * @PARAM {int} foo 
 */  

function flucvar (foo) {

}

Когда вы нажимаете enter в комментарии, eclipse автоматически добавляет дополнительные * в начале каждой строки.

Теперь я просто вхожу в свою текстовую канавку и обнаруживаю, что мне не хватает этой небольшой функциональности. Есть ли эквивалентный пакет или команда или что-то, что позволило бы мне создавать аналогичные комментарии в textmate?

Ответы [ 3 ]

7 голосов
/ 03 января 2009

Вам нужно создать два фрагмента (они у меня есть в комплекте с исходным кодом).

Сначала создайте фрагмент для вставки комментариев JavaDoc. Фрагмент содержит следующее:

/**
* $0
*/

У меня активация сниппета установлена ​​на Триггер табуляции с использованием /** в качестве строки активации. Каждый раз, когда я пишу /** и нажимаю клавишу Tab, я получаю блок комментариев JavaDoc. Вы также можете использовать сочетание клавиш, если хотите.

Второй фрагмент для продолжения существующих комментариев JavaDoc. Содержимое фрагмента:

* $0

Обратите внимание, что перед строкой * $0 есть пустая строка. Установите для параметра «Активация» значение Эквивалент ключа , а для кнопки запуска значение , нажмите клавишу . Установите для строки Scope Selector значение comment.documentation.

.

Теперь, если ваш языковой пакет поддерживает область действия comment.documentation (как, кажется, делают все включенные пакеты), у вас должны быть рабочие ярлыки для комментариев JavaDoc.

1 голос
/ 03 января 2009

Я взглянул на Java-пакет TextMate и ничего не увидел о вставке комментариев JavaDoc. Однако добавить такую ​​функцию в ваш Java-пакет не должно быть так сложно. Скорее всего, это будет фрагмент кода, о котором вы можете прочитать в главе 7 руководства TextMate (доступ к которому Help -> TextMate Help).

0 голосов
/ 03 января 2009

спасибо за этот ответ. Я только что нашел этот пост на сайте macromates

http://blog.macromates.com/2006/customization-screencast/

Похоже, здесь есть видео / список рассылки, в котором подробно объясняется, как это сделать.

...