emacs - Emacs 中函数的注释

标签 emacs comments elisp doxygen doc

我正在寻找一种方法来在 Emacs 中的函数上方生成和插入标题注释 block (在任何模式下),注释的默认内容自动基于函数的签名(即 @param 位置的正确数量) -持有者)。

Doxymacs 是一个不错的候选者。但我更喜欢另一种无需必要库的方法。谁能推荐一些其他方法来为 Emacs 中的函数添加智能注释?谢谢。

编辑: 现在我发现了这个:http://nschum.de/src/emacs/doc-mode/ ,但在我需要它到我的 .emacs 并添加 js-mode 的钩子(Hook)后,它似乎不能很好地工作。不支持js函数吗?

最佳答案

我不知道有什么通用方法。

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

image

它没有以任何方式通用化以支持 javascript 或其他语言语法。但如果你从那开始,你也许能够构建你想要的东西。

以下是摘录:

http://pastebin.com/ATCustgi

关于emacs - Emacs 中函数的注释,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/9872445/

相关文章:

linux - 如何在bash中为printf的每一行添加注释?

emacs - 如何在 Emacs 中建议原语

emacs - 是否有访问上次编辑的 emacs 功能?

rest - 额外的 header 未通过 url.el 发送

正则表达式在 emacs 中去除 URL 后的字符

objective-c - Xcode 中针对 Objective-C 的类似 JavaDoc 的文档?

c# - HTMLAgilityPack 选择注释之间的节点

macos - Slime-repl 不在这里

emacs - Elisp 函数返回标记而不是正确的值

emacs - Emacs calc 的当前版本在哪里?