Комментарии для функции в Emacs

Question

Я ищу способ генерировать и вставлять блоки комментариев заголовка над моими функциями в Emacs (в любом режиме), с содержимым комментария по умолчанию, автоматически основанным на сигнатуре функции (то есть правильном числе @param place -holders).

Doxymacs - хороший кандидат. Но я предпочитаю другой способ работы без необходимых библиотек. Кто-нибудь может порекомендовать некоторые другие способы добавления умных комментариев для функций в Emacs? Спасибо.

Edit: Теперь я нашел это: http://nschum.de/src/emacs/doc-mode/,, но кажется, что он не работает должным образом после того, как я ввел его в свой .emacs и добавил хук для js-mode. Разве он не поддерживает функции js?

Answer 1

Я не знаю ни одного универсального подхода.

Csharp-mode имеет defun, связанный с /, который пытается генерировать комментарии, подходящие для C #.Как это работает: Каждый раз, когда вы вводите косую черту, она проверяет, является ли она третьей косой чертой в ряду.(В C # три слеша используются для обозначения комментариев, которые создают документацию).Если это третий слеш, он просматривает окружающий текст и вставляет соответствующий скелет или фрагмент комментария.

Он не обобщен каким-либо образом для поддержки синтаксиса JavaScript или других языков.Но вы можете построить то, что хотите, если начнете с этого.

вот выдержка:

http://pastebin.com/ATCustgi

Answer 2

В прошлом я использовал doxymacs и нашел его полезным http://doxymacs.sourceforge.net/