come iniziare a utilizzare la documentazione di Emacs?

Question

Desidero familiarizzare con i sistemi di guida di auto-documentazione di Emacs in modo da poter capire le cose da solo.

Esempio: Voglio imparare come utilizzare la proprietà :VISIBILITY: di org-mode in modo che sia possibile rendere sempre aperti alcuni sottoalberi in uno stato espanso.

ho preso una congettura quanto alla sintassi ...

:VISIBILITY: CHILDREN

... ma non ha funzionato.

Quindi voglio utilizzare il sistema di aiuto per capirlo.

così faccio questo:

M-x apropos

simbolo Apropos (elenco di parole o regexp): org visibility

Nessun aiuto lì.

C-h v Descrivere variabile org visibility org-inibizione-startup-visibilità-stuff

Nessun aiuto lì.

C-h a visibility

org-set-visibilità-secondo-to-proprietà è un interattivo funzione Lisp in `org.el'.

(org-set-visibilità-secondo-to-struttura & opzionale NO-CLEANUP)

visibilità Passare sottostruttura secondo: VISIBILITÀ: struttura.

C-h a visibility

org-cavicchio-custom-proprietà-visibilità è un interattivo funzione Lisp in `org.el'.

(org-Toggle-custom-proprietà-visibilità)

... e non ho più vicini sono ancora di sapere come utilizzare la proprietà di org-mode :VISIBILITY:.

Come posso utilizzare meglio il sistema di guida per trovare quello che sto cercando?

Answer 1

I manuali di informazioni sono la documentazione più dettagliata e sono tutti indicizzati.

Per comodità, i (emacs) e (elisp) manuali hanno entrambi i comandi per la ricerca il loro indice da qualsiasi luogo (emacs-index-search e elisp-index-search), ma ci sono molte librerie che hanno un proprio manuale di alto livello, e non sorprende org-mode è una delle loro.Lo vedrete elencate nella pagina principale quando si digita Chi (seguita da d se si sta già leggendo qualche altra pagina info), oppure si può passare direttamente ad esso con:

Chig(org)RET

potrebbe essere necessario imparare ad usare il lettore informazioni prima. Dal buffer *info* è possibile digitare h per iniziare il suo tutorial e d per tornare alla pagina di livello superiore (che ha alcune note utili in alto).

Una volta entrato in qualsiasi manuale specifico, è possibile cercare l'indice con I (lettera maiuscola i). Si noti che anche la minuscola i cerca, ma trovo il primo più utile in generale.

quindi in questo caso vorrei provare prima ho:VISIBILITY:RET

che non dà risultati (e faccio notare che in realtà è ignorando il leader : per qualche motivo sono incerto in questo momento), ma provare di nuovo con VISIBILITY (senza i due punti) fornisce una serie di risultati che è possibile seguire (principalmente nel nodo (org) Visibility cycling, in cui è possibile visualizzare l'elenco di valori che si sta cercando).

È anche possibile cercare il testo di un manuale nel modo normale con C-s. Questo cercherà nel nodo corrente ma, in caso di errore, digitando C-s si passerà nuovamente al successivo nodo corrispondente trovato in quel manuale. Questo è incredibilmente utile se la cosa che stai cercando non è indicizzata.

Si noti che se non si sa quale manuale cercare, è possibile cercare tutti i manuali informazioni utilizzando info-apropos (che è naturalmente molto più lento).

C'è anche lo http://emacswiki.org/emacs/SelfDocumentation (che non entra in molti dettagli, ma almeno è necessario assicurarsi che si abbia familiarità con le cose che menziona).