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

Question

我想熟悉 Emacs 的自文档化帮助系统，以便自己解决问题。

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

我猜了一下语法...

:VISIBILITY: CHILDREN

...但是没有用。

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

所以我这样做：

M-x apropos

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

那里没有帮助。

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

那里没有帮助。

C-h a visibility

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

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

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

C-h a visibility

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

(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（没有详细说明，但您至少应该确保您熟悉其中提到的内容）。