elisp - 我应该在我的 Emacs Lisp 包中的什么地方添加自动加载 cookie？有权威的指南吗？

Question

我维护着一个比较流行的 Emacs 包 ( ido-ubiquitous )，我想在我的包中添加 ;;;###autoload 注释，这样它就不需要加载了直到其模式被激活。不久前我尝试使用同一个包进行此操作，结果导致了一些只有在自动加载包时才会发生的神秘错误，所以我删除了所有自动加载的东西，问题就消失了。我想再试一次，但前提是我能找到关于如何操作的权威文档，这样我就不会再次引入相同的错误。

那么是否有关于将自动加载 cookie 添加到 Emacs Lisp 包的权威指南？

编辑:查看我的包的 Git 日志，我看到几个提交涉及自动加载:

• 283f9e9删除不必要的自动加载
• 66b782f自动加载覆盖变量的默认值
• f6086e5自动加载修复
• 0eed206删除不必要的自动加载 cookie

这些提交表明我真的不确定要向什么添加自动加载。特别是，f6086e5 和 66b782f 表明我认为我应该自动加载自定义变量，并得出结论我还需要自动加载定义其默认值的 defconst 表单。如果我没记错的话，这是对无效变量错误的响应，因为自动加载的 defcustom 无法访问非自动加载的默认值 ( issue link )。最后，在 283f9e9 中，我对 future 有了一个展望，并采纳了 Stefan 的建议，删除了除次要模式定义之外的所有自动加载。

Answer 1

;;;###autoload cookie 只是将需要提升到 <pkg>-autoloads.el 中的代码标记出来。文件。然后在启动时急切地加载此文件，但可以快速完成，因为它是一个小得多的文件。因此，您通常只需要在几个主要入口点上使用这样的 cookie。例如。我会先将一个这样的 cookie 放在 ido-ubiquitous-mode 上.