Emacs 中函数的注释答案

【问题标题】：Comments for Function in EmacsEmacs 中函数的注释
【发布时间】：2012-03-26 12:50:15
【问题描述】：

我正在寻找一种方法来生成并在 Emacs 中的函数上方插入标题注释块（以任何模式），注释的默认内容自动基于函数的签名（即 @param 位置的正确数量-持有人）。

Doxymacs 是一个不错的候选者。但我更喜欢另一种没有必要库的工作方式。谁能推荐一些其他方法来为 Emacs 中的功能添加智能 cmets？谢谢。

编辑： 现在我发现了这个：http://nschum.de/src/emacs/doc-mode/，但是在我将它放入我的 .emacs 并为 js-mode 添加钩子之后，它似乎不能正常工作。不支持js函数吗？

【问题讨论】：

你是指elisp中的函数还是你用Emacs编辑的函数？
我的意思是任何程序语言的任何函数。当我使用 eclipse 时，我在函数定义的第一行上方输入“/**”，cmets 像：“/** \n *@desc\n *@param\n *@return\n **/”将自动生成。此外，“参数”的数量将基于函数签名

【解决方案1】：

我不知道任何通用方法。

Csharp-mode 有一个绑定到 / 的 defun，它会尝试生成适用于 C# 的 cmets。它的工作方式：每次键入斜线时，它都会查看它是否是连续的第三个斜线。（在 C# 中，三个斜杠用于表示生成文档的 cmets）。如果是第三个斜线，那么它会查看周围的文本并插入适当的注释骨架或片段。

它没有以任何方式推广以支持 javascript 或其他语言语法。但是，如果您从它开始，您也许可以构建您想要的东西。

摘录如下：

【讨论】：

【解决方案2】：

我过去使用过 doxymacs，我发现它很有用 http://doxymacs.sourceforge.net/

【讨论】：