如何开始使用Emacs文档?

Question

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

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

我尝试了以下语法：:VISIBILITY: CHILDREN，但它没有起作用。因此，我想使用帮助系统来找出原因。

所以我这样做： M-x apropos Apropos符号（单词列表或正则表达式）：org visibility 没有任何帮助。 C-h v 描述变量org visibility org-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:属性。

我如何更好地使用帮助系统以找到我需要的信息？

- incandescentman

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 （虽然没有提供详细信息，但至少应确保您熟悉它所提到的内容）。

- phils