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

Търся начин да генерирам и вмъквам блокове с коментари за заглавки над моите функции в Emacs (във всеки режим), като съдържанието по подразбиране на коментара автоматично се базира на подписа на функцията (т.е. правилния брой @param контейнери за място) .

Doxymacs е добър кандидат. Но предпочитам друг начин да работи без необходимите библиотеки. Може ли някой да препоръча други начини за добавяне на интелигентни коментари за функции в Emacs? Благодаря.

Редактиране: Сега намерих това: http://nschum.de/src/emacs/doc-mode/, но изглежда, че не работи добре, след като го изисквам в моя .emacs и добавям кука за js-mode. Не поддържа ли js функции?


comments doc emacs doxygen elisp
person Boris    schedule 26.03.2012    source източник
comment
Имате предвид функции в elisp или функции, които редактирате с Emacs?   -  person Tim Landscheidt    schedule 27.03.2012
comment
Имам предвид всякакви функции на всеки програмен език. Когато използвам eclipse, пиша /** над първия ред на дефиницията на функция, коментари като: /** \n *@desc\n *@param\n *@return\n **/ ще се генерират автоматично. Освен това броят на параметрите ще се основава на сигнатурата на функцията   -  person Boris    schedule 27.03.2012

Отговори (2)


arrow_upward
2
arrow_downward

Не знам за някакъв подход с общо предназначение.

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

изображение

Не е генерализиран по никакъв начин, за да поддържа javascript или друг езиков синтаксис. Но може да успеете да изградите това, което искате, ако започнете с това.

ето откъса:

http://pastebin.com/ATCustgi

person Cheeso    schedule 07.05.2012
comment
Благодаря Чийзо. Хубаво предложение. :) - person Boris; 10.05.2012

arrow_upward
0
arrow_downward

Използвал съм doxymacs в миналото и го намирам за полезен http://doxymacs.sourceforge.net/

person perogiex    schedule 03.04.2012