在emacs的明星註釋塊

Question

什麼設置和命令沒有一個需要執行作出這樣的評論在Emacs：

/** 
    * 
    * something here 
    */ 

感謝。

Answer 1

一個簡單的方法是定義自己的命令來插入這個 評論。添加到您的.emacs文件：

(defun insert-doc-comment() (interactive) 
    (insert "/**\n * Brief description. Long description. \n * @param \n * @return \n * @exception \n * @see \n * @author \n */")) 

新的命令然後綁定自己的喜好的關鍵：

(define-key global-map [(S-f1)] 'insert-doc-comment) 

現在按Shift-F1將插入一個註釋塊這樣的：

/** 
* Brief description. Long description. 
* @param 
* @return 
* @exception 
* @see 
* @author 
*/ 

Answer 2

您正在尋找M-x comment-region及其朋友的特定模式。

Answer 3

您可以使用emacs構建模板。模板是文件結構的骨架，可以綁定到具有特定擴展名的文件。例如，您可以創建一個適用於您使用.java擴展名創建的任何新文件的java模板，並且可以創建一個C++模板，該模板適用於您使用.cpp擴展名創建的任何文件（另一個用於.h文件如果需要的話）。

這個wiki有更多的例子來幫助你開始使用C++類模板。

Answer 4

您可以定義一個鍵盤宏來完成工作，然後運行它。對於你的情況，輸入開始/*，然後做C-x (然後，C-n M-m *和C-x)。做C-x e直到你想註釋掉的最後一行。在最後一行時，以/結束。

我知道它看起來很醜，而且這樣，但FWIW，它適用於我。當我不得不評論大塊時，我使用這種方法。

Answer 5

M-x customize-group RET comment 

看看「Comment Style」變量的「Value Menu」。

（然後你就可以同時使用「的評論，DWIM」或「評論或 - 取消註釋區域」來切換意見進出選定塊）

您還可以，如果你想在當前行使用此註釋輸入/輸出，如果沒有區域活躍：

(defun px-toggle-comments() 
    "If region is set, [un]comments it. Otherwise [un]comments current line." 
    (interactive) 
    (if (eq mark-active nil) 
     (progn 
       (beginning-of-line 1) 
       (set-mark (point)) 
       (forward-line) 
       (comment-dwim nil)) 
    (comment-dwim nil)) 
    (deactivate-mark)) 

我通常把它綁定到MD：

(global-set-key (kbd "M-d") 'px-toggle-comments) 

Answer 6

使用yasnippet snipept，如果你不使用它，試試吧。

在你的片段將這個/ ** - 模式/

# -*- mode: snippet -*- 
# name: dock 
# key: /* 
# -- 
/* 
* $1 
*/ 
$0 

或另一個版本：

# -*- mode: snippet -*- 
# name: docblock 
# key: /** 
# -- 
/** 
* ${1:name} - ${2:short description} 
* @${3:argv1}: $4 
* @${5:argv2}: $6 
* 
* ${7:long description} 
*/ 
$0 

我得到了兩個兩個我片段/，順便說一句，你應該複製yasnippets-xx/snippets到像~/.emacs.d/snippets另一個地方，並把這個在您的.emacs：

(setq yas-snippet-dirs '("~/.emacs.d/snippets")) 

在每次更新yasnippet時，yasnippet-xx/snippets將被作者的片段取代，您可以在~/.emacs.d/snippets中根據自己的需要add/delete/modify自己的片段。