2012-03-26 88 views
2

我正在尋找一種方法來在Emacs中的函數上方(在任何模式下)生成並插入頭部註釋塊,註釋的默認內容將根據函數的簽名自動生成(即正確參與者的數量)。Emacs中的函數的註釋

Doxymacs是一個很好的候選人。但我更喜歡另一種方式,沒有必要的庫。任何人都可以推薦一些其他方法來爲Emacs中的函數添加智能註釋嗎?謝謝。

編輯: 現在我發現這一點:http://nschum.de/src/emacs/doc-mode/,但它似乎不工作做好後我需要到我的.emacs和JS-模式中添加掛鉤。它不支持js功能嗎?

+1

你的意思是在elisp的,或者你使用Emacs編輯功能的功能呢? – 2012-03-26 21:11:10

+0

我的意思是任何程序語言的任何功能。當我使用eclipse時,我在函數定義的第一行上方鍵入「/ **」,註釋如下:「/ ** \ n * @ desc \ n * @ param \ n * @ return \ n ** /」將自動生成。此外,「param」的數量將基於功能簽名 – Boris 2012-03-27 01:44:28

回答

2

我不知道任何通用的辦法。

Csharp模式有一個defun綁定到/,它會嘗試生成適合C#的註釋。它的工作方式:每次輸入一個斜槓時,它都會查看它是否是連續的第三個斜槓。 (在C#中,三個斜線用於表示生成文檔的註釋)。如果它是第三個斜槓,則它會查看周圍的文本並插入適當的註釋框架或片段。

image

它不以任何方式支持JavaScript或其他語言的語法一概而論。但是如果你從這個開始,你可能能夠建立你想要的東西。

這裏的摘錄:

http://pastebin.com/ATCustgi

+0

謝謝Cheeso。好的建議。 :) – Boris 2012-05-10 13:58:28