Come posso leggere la documentazione sui comandi zsh incorporati?

Prova uno di questi:

man zshbuiltins

o

man zshall

Le pagine man per zsh sono divise per argomento, man zsh è principalmente un sommario e un'introduzione mentre man zshall è tutto (24628 righe sul mio sistema rispetto alle 5242 per man bash ).

Per quanto riguarda bindkey , man zshbuiltins ti rimanderà a man zshzle .

Le informazioni chiave per ottenere un'utilità di aiuto più utile sono in realtà incluse in Zsh, si tratta solo di trovare la pagina man critica e scarsamente rilevabile:man zshcontrib (qui sul web), che descrive il run-help widget:

Per impostazione predefinita, run-help è un alias per man comando, quindi questo spesso fallisce quando la parola di comando è un built-in della shell o una funzione definita dall'utente. Ridefinendo il run-help alias, si può migliorare l'help in linea fornito dalla shell.

Spiega inoltre come sostituirlo con un miglioramento integrato.

Dopo averlo configurato, chiamando run-help per i nomi dei builtin, le funzioni di completamento e così via ora cercheranno di mostrarti la documentazione estratta, o di mostrarti la pagina man contenente i diritti, ecc. Ad esempio run-help bindkey uscite:

bindkey
   See the section `Zle Builtins' in zshzle(1).

che potrebbe essere migliore. Per un esempio migliore, run-help history mostra la sezione della pagina man di Zsh per fc , che è il comando alla base di history .

Utile anche notare:ESC-h chiamerà run-help per il comando sulla riga di input corrente.

Presumo che questa configurazione non sia l'impostazione predefinita perché estraendo i dati granulari della guida e impostando HELPDIR indicarlo potrebbe essere una decisione di packaging lasciata alle distribuzioni del sistema operativo. C'è anche una scelta dell'utente:il autoload run-help util è utile senza impostare HELPDIR affatto. Sembra essere bravo a portarti alla pagina man giusta anche se non può saltare alla sezione esatta per un elemento. Alcuni potrebbero preferire questo piuttosto che imbattersi in casi come il bindkey esempio sopra che fa solo perdere tempo. (Perché il loro valore predefinito è alias run-help=man quindi, non riesco a capire).

Per Zsh versione 5.0.3 o successiva

Il helpfiles le estrazioni sono probabilmente incluse nella distribuzione Zsh. È solo questione di trovarli sul tuo sistema per impostare HELPDIR se lo desideri, i probabili candidati sono in /usr/share/zsh o /usr/local/share/zsh , cerca help sottocartella.

Per le versioni di Zsh precedenti alla 5.0.3

Probabilmente dovrai seguire la procedura dettagliata in man zshcontrib te stesso per generare i file di aiuto. È un po' fastidioso doverlo fare, ma per il resto è rapido e indolore.

Trova la tua versione installata con zsh --version e ottenere il corrispondente tarball sorgente dall'archivio sourceforge. Quindi esegui helpfiles script come mostrato nella pagina man e imposta il target come HELPDIR nel tuo ~/.zshrc .