我正在寻找一种方法来在 Emacs 中的函数上方生成和插入标题注释 block (在任何模式下),注释的默认内容自动基于函数的签名(即 @param 位置的正确数量) -持有者)。
Doxymacs 是一个不错的候选者。但我更喜欢另一种无需必要库的方法。谁能推荐一些其他方法来为 Emacs 中的函数添加智能注释?谢谢。
编辑: 现在我发现了这个:http://nschum.de/src/emacs/doc-mode/ ,但在我需要它到我的 .emacs 并添加 js-mode 的钩子(Hook)后,它似乎不能很好地工作。不支持js函数吗?
最佳答案
我不知道有什么通用方法。
Csharp-mode 有一个绑定(bind)到/的 defun,它尝试生成适合 C# 的注释。它的工作方式:每次您键入斜杠时,它都会查看它是否是连续的第三个斜杠。 (在 C# 中,三个斜杠用于表示生成文档的注释)。如果是第三个斜杠,那么它会查看周围的文本并插入适当的注释框架或片段。
它没有以任何方式通用化以支持 javascript 或其他语言语法。但如果你从那开始,你也许能够构建你想要的东西。
以下是摘录:
关于emacs - Emacs 中函数的注释,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/9872445/