Versuchen Sie es mit einem der folgenden:
man zshbuiltins
oder
man zshall
Die Manpages für zsh sind nach Themen unterteilt, man zsh
ist meistens ein Inhaltsverzeichnis und eine Einführung, während man zshall
ist alles (24628 Zeilen auf meinem System im Vergleich zu 5242 für man bash
).
Wie bei bindkey
, man zshbuiltins
verweist Sie auf man zshzle
.
Die wichtigsten Informationen zum Abrufen eines nützlicheren Hilfsprogramms sind tatsächlich in Zsh enthalten, es ist nur eine Frage der Suche nach der kritischen – und schlecht auffindbaren – Manpage:man zshcontrib
(hier im Web), das den run-help
beschreibt Widget:
Standardmäßig run-help
ist ein Alias für man
Befehl, daher schlägt dies oft fehl, wenn das Befehlswort eine eingebaute Shell oder eine benutzerdefinierte Funktion ist. Durch Neudefinition des run-help
alias kann man die von der Shell bereitgestellte Online-Hilfe verbessern.
Außerdem wird erklärt, wie man es durch eine eingebaute Verbesserung ersetzt.
Rufen Sie nach der Einrichtung run-help
an für Namen von eingebauten Funktionen, Vervollständigungsfunktionen usw. versucht nun, Ihnen die extrahierte Dokumentation oder die richtige enthaltende Manpage usw. anzuzeigen. Zum Beispiel run-help bindkey
Ausgaben:
bindkey
See the section `Zle Builtins' in zshzle(1).
was besser sein könnte. Für ein besseres Beispiel run-help history
zeigt den Abschnitt der Zsh-Manpage für fc
, das ist der Befehl, der history
zugrunde liegt .
Auch praktisch zu beachten:ESC-h
ruft run-help
an für den Befehl in der aktuellen Eingabezeile.
Ich nehme an, dass dieses Setup nicht die Standardeinstellung ist, da die granularen Hilfedaten extrahiert und HELPDIR
eingestellt werden darauf hinzuweisen, könnte eine Verpackungsentscheidung sein, die den Betriebssystem-Distributionen überlassen bleibt. Es gibt auch eine Benutzerauswahl:die autoload run-help
util ist nützlich, ohne HELPDIR
zu setzen überhaupt. Es scheint gut darin zu sein, Sie zur richtigen Manpage zu bringen, auch wenn es nicht zum genauen Abschnitt für ein Element springen kann. Einige ziehen es vielleicht vor, auf Fälle wie bindkey
zu stoßen Beispiel oben, das nur Zeit verschwendet. (Warum sie standardmäßig auf alias run-help=man
gesetzt sind dann kann ich nicht ergründen).
Für Zsh-Version 5.0.3 oder neuer
Der helpfiles
Extraktionen sind wahrscheinlich in der Zsh-Distribution enthalten. Sie müssen sie nur auf Ihrem System finden, um HELPDIR
einzustellen wenn Sie möchten – wahrscheinliche Kandidaten sind in /usr/share/zsh
oder /usr/local/share/zsh
, suchen Sie nach help
Unterverzeichnis.
Für Versionen von Zsh vor 5.0.3
Sie müssen wahrscheinlich dem in man zshcontrib
beschriebenen Verfahren folgen um die Hilfedateien zu generieren. Es ist ein wenig lästig, dies tun zu müssen, aber ansonsten schnell und schmerzlos.
Finden Sie Ihre installierte Version mit zsh --version
und holen Sie sich den entsprechenden Quell-Tarball aus dem Sourceforge-Archiv. Führen Sie dann helpfiles
aus Skript wie in der Manpage gezeigt und setzen Sie das Ziel auf HELPDIR
in Ihrem ~/.zshrc
.