Wie kann ich die Emacs-Dokumentation verwenden?

Question

Ich möchte mich mit den selbstdokumentierenden Hilfesystemen von Emacs vertraut machen, damit ich die Dinge selbst herausfinden kann.

Beispiel: Ich möchte lernen, wie die :VISIBILITY:-Eigenschaft des Organisationsmodus verwendet wird, damit ich bestimmte Unterstrukturen immer in einem erweiterten Zustand öffnen kann.

nahm ich eine Vermutung in Bezug auf die Syntax ...

:VISIBILITY: CHILDREN

... aber es hat nicht funktioniert.

Also ich möchte das Hilfesystem verwenden, um es herauszufinden. So

ich dies tun:

M-x apropos

propos Symbol (Wortliste oder regexp): org visibility

keine Hilfe gibt.

C-h v Beschreiben variable org visibility org-Verhinderungs-Startup-Sichtbarkeit-stuff

Nein, es Hilfe.

C-h a visibility

org-set-Sicht-nach-to-Eigenschaft ist eine interaktive Funktion Lisp in `org.el‘.

(org-set-Sichtbarkeits-nach-to-Eigenschaft & optional NO-cleanup)

Schalterteilbaum visibilities gemäß: VISIBILITY: Eigenschaft.

C-h a visibility

org-Toggle-custom-Eigenschaften-Sichtbarkeit ist eine interaktive Funktion Lisp in `org.el‘.

(org-Toggle-custom-Eigenschaften-Sichtbarkeit)

... und ich bin immer noch nicht näher zu wissen, wie man verwendet :VISIBILITY: Unterkunft org-Modus.

Wie kann ich das Hilfesystem besser verwenden, um zu finden, nach was ich suche?

Answer 1

Die Informationshandbücher sind die ausführlichste Dokumentation, und sie sind alle indiziert.

Als Bequemlichkeit, die (emacs) und (elisp) Handbücher haben beiden Befehle für ihren Index von jedem beliebigen Ort suchen (emacs-index-search und elisp-index-search), aber es gibt viele Bibliotheken, die ihr eigenes Top-Level-Handbuch haben, und wenig überraschend org-Modus ist eine der Sie.Sie werden sehen, es auf der Hauptseite aufgelistet, wenn Sie geben Chi (von d gefolgt, wenn Sie gelesen haben bereits eine andere Info-Seite), oder Sie können mit direkt angesprungen werden:

Chig(org)RET

möglicherweise müssen Sie lernen, wie die Info-Leser zuerst verwenden. Aus dem *info* Puffer können Sie h eingeben, um das Lernprogramm zu starten, und d, um zur obersten Seite zurückzukehren (die oben einige nützliche Hinweise enthält).

Sobald Sie in einem bestimmten Handbuch sind, können Sie den Index mit I (Großbuchstabe i) suchen. Beachten Sie, dass Kleinbuchstaben i auch sucht, aber ich finde ersteres im Allgemeinen nützlicher.

so in diesem Fall würde ich versuchen, erste ich:VISIBILITY:RET

, dass keine Ergebnisse gibt (ich bin nicht sicher gerade jetzt, und ich stelle fest, dass es die führende : aus irgendeinem Grund tatsächlich ist zu ignorieren), Aber versuchen Sie es erneut mit VISIBILITY (ohne die Doppelpunkte) gibt eine Reihe von Ergebnissen, die Sie folgen können (in erster Linie in der (org) Visibility cycling Knoten, in denen ich die Liste der Werte, die Sie suchen).

Sie können auch den Text eines Handbuchs in der üblichen Weise mit C-s suchen. Das wird im aktuellen Knoten suchen, aber bei einem Fehler wird die Eingabe von C-s erneut zum nächsten übereinstimmenden Knoten führen, den es in diesem Handbuch findet. Dies ist sehr nützlich, wenn das gesuchte Objekt nicht indiziert ist.

Hinweis: Wenn Sie nicht wissen, welches Handbuch Sie suchen, können Sie alle Handbücher mit info-apropos (die natürlich viel langsamer ist) suchen.

Es gibt auch http://emacswiki.org/emacs/SelfDocumentation (was nicht ins Detail geht, aber Sie sollten zumindest sicherstellen, dass Sie mit den Dingen vertraut sind, die es erwähnt).