emacs - 我如何开始使用 Emacs 的文档？

Question

我想熟悉 Emacs 的自文档帮助系统，这样我就可以自己解决问题了。

示例：我想学习如何使用 org-mode 的:VISIBILITY:属性，以便我可以使某些子树始终以展开状态打开。

我猜了一下语法...

:VISIBILITY: CHILDREN

......但它没有工作。

所以我想使用帮助系统来解决这个问题。

所以我这样做：

M-x apropos

Apropos 符号（单词列表或正则表达式）：org visibility

那里没有帮助。

C-h v描述变量org visibilityorg-inhibit-startup-visibility-stuff

那里没有帮助。

C-h a visibility

org-set-visibility-according-to-property 是“org.el”中的一个交互式 Lisp 函数。

(org-set-visibility-according-to-property & optional NO-CLEANUP)

根据 :VISIBILITY: 属性切换子树可见性。

C-h a visibility

org-toggle-custom-properties-visibility 是“org.el”中的一个交互式 Lisp 函数。

(org-toggle-custom-properties-visibility)

...而且我仍然不知道如何使用 org-mode 的:VISIBILITY:属性。

我怎样才能更好地使用帮助系统来找到我正在寻找的东西？

Answer 1

信息手册是最详细的文档，它们都已编入索引。

为方便起见，(emacs)和(elisp)手册都有从任何地方搜索索引的命令（emacs-index-search和elisp-index-search），但是有许多库都有自己的顶级手册，毫不奇怪 org-mode 就是其中之一。当您键入时，您会在主页中看到它（如果您已经在阅读其他信息页面，则C-hi紧随其后），或者您可以直接跳转到它：d

C-hig (org) RET

您可能需要先学习如何使用信息阅读器。您可以从*info*缓冲区键入h开始其教程，并d返回到顶级页面（顶部有一些有用的注释）。

一旦你在任何特定的手册中，你可以用I（大写字母i）搜索索引。请注意，小写i也可以搜索，但我发现一般来说前者更有用。

所以在这种情况下，我会先尝试I :VISIBILITY: RET

这没有给出任何结果（我注意到由于:某种原因我现在不确定它实际上忽略了领先），但是再次尝试VISIBILITY（不带冒号）会给出一堆你可以遵循的结果（主要在(org) Visibility cycling节点中，我可以在其中看到您要查找的值列表）。

您也可以使用C-s. 这将在当前节点中搜索，但如果失败，C-s再次键入会将您带到它在该手册中找到的下一个匹配节点。如果您要查找的内容未编入索引，这将非常有用。

请注意，如果您不知道要搜索哪个手册，您可以使用搜索所有信息手册info-apropos（这自然要慢得多）。

还有http://emacswiki.org/emacs/SelfDocumentation（没有详细说明，但您至少应该确保您熟悉它提到的内容）。