Emacs Lisp 功能指南？

Question

我已经使用 Emacs 三年多了，但我仍然需要几天时间用 Lisp 编写小函数。我浏览了GNU Emacs Lisp Reference Manual但它庞大且结构化与 JavaDoc 完全相反，不是从函数到描述，而是相反。

让我的生活更轻松的是某种小型 JavaDoc 文档，其中包含最常用的 Emacs 内部函数和快速描述。

(point) - 返回缓冲区中的当前位置
(save-excursion (p)) - 在缓冲区中保存当前位置之前
执行 (p) 并在之后恢复它。

有谁知道我在哪里可以找到这样的东西？

Answer 1

您是否尝试过 emacs 中的内置手册？打开任何 lisp 缓冲区(或 lisp 模式下的任何缓冲区)，将您的点移动到任何函数或变量，然后点击 C-h f(函数)或 C-h v(变量)。 Emacs 会给你一个相当简洁的函数/变量描述。

例如，(save-excursion) 的手册内容是

save-excursion is a special form in `C source code'.
(save-excursion &rest BODY)

Save point, mark, and current buffer; execute BODY; restore those things.
Executes BODY just like `progn'.
The values of point, mark and the current buffer are restored
even in case of abnormal exit (throw or error).
The state of activation of the mark is also restored.

This construct does not save `deactivate-mark', and therefore
functions that change the buffer will still cause deactivation
of the mark at the end of the command.  To prevent that, bind
`deactivate-mark' with `let'.

还有一个好处是内置手册为您提供了指向函数源代码和其他可能相关函数的“链接”，这使得浏览起来很方便。

当然，你不能通过这种方式学习 lisp，但是对于查找函数的文档，这是一个很好的入门。当您发现内置手册无法理解时(有时确实会发生)，那么您就该用谷歌搜索该功能了；)