我如何开始使用Emacs'文档?

时间:2013-02-16 21:58:14

标签: emacs org-mode

我想熟悉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-based-to-property是一个交互式Lisp 函数在`org.el'。

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

根据以下内容切换子树可见性:可见性:属性。

C-h a visibility

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

(ORG-肘节定制属性能见度)

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

如何更好地使用帮助系统来查找我正在寻找的内容?

1 个答案:

答案 0 :(得分:11)

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

为方便起见,(emacs)(elisp)手册都有从任何地方(emacs-index-searchelisp-index-search)搜索索引的命令,但有许多库都有他们自己的顶级手册,毫不奇怪的组织模式就是其中之一。当您键入 Ch i 时,您会看到它在主页面中列出(如果您已经阅读了其他信息页面,则显示 d ) ,或者你可以直接跳到它:

C-h i g (org) RET

您可能需要先学习如何使用信息阅读器。从*info*缓冲区,您可以键入 h 来开始其教程,然后输入 d 返回顶层页面(顶部有一些有用的注释)

在使用任何特定手册后,您可以使用 I (大写字母i)搜索索引。请注意,小写 i 也会搜索,但我发现前者更有用。

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

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

您也可以通过 C-s 以正常方式阅读手册的文本。这将在当前节点中搜索,但在失败时再次键入 C-s 将带您到该手册中找到的下一个匹配节点。如果您要查找的内容未编入索引,这非常有用。

请注意,如果您不知道要搜索的手册,可以使用info-apropos搜索所有信息手册(这自然要慢得多)。

还有http://emacswiki.org/emacs/SelfDocumentation(没有详细说明,但你至少应该确保你熟悉它提到的事情。)