GNU/Linux >> LINUX-Kenntnisse >  >> Linux

Wie kann ich die Dokumentation zu integrierten zsh-Befehlen lesen?

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 .


Linux
  1. Wie verwendet man Manpages, um zu lernen, wie man Befehle verwendet?

  2. Wie liest man Manpages in der Muttersprache?

  3. Wie kann ich Alias-Befehle mit xargs verwenden?

  4. Wie kann ich als anderer Benutzer mit sudo eine Reihe von Befehlen in einer Bash-Subshell ausführen?

  5. Wie lese ich den Quellcode von Shell-Befehlen?

So verwenden Sie Bash-Verlaufsbefehle

So lesen Sie eine Datei Zeile für Zeile in Bash

So durchsuchen und lesen Sie das gesamte Arch-Wiki als Linux-Manpages

So installieren Sie fehlende Manpages von Befehlen auf Ubuntu

Wie kann ich eine dauerhafte SSH-Verbindung erstellen, um Befehle über einen bestimmten Zeitraum zu streamen?

Wie kann ich disk io überwachen?