Jak mohu číst dokumentaci o vestavěných příkazech zsh?

Zkuste některý z těchto:

man zshbuiltins

nebo

man zshall

Manuálové stránky pro zsh jsou rozděleny podle tématu man zsh je většinou obsah a úvod, zatímco man zshall je všechno (24628 řádků v mém systému ve srovnání s 5242 pro man bash ).

Pokud jde o bindkey , man zshbuiltins vás odkáže na man zshzle .

Klíčové informace pro získání užitečnějšího nástroje nápovědy jsou ve skutečnosti součástí Zsh, jde jen o to najít kritickou – a špatně zjistitelnou – manuálovou stránku:man zshcontrib (zde na webu), který popisuje run-help widget:

Ve výchozím nastavení run-help je alias pro man příkaz, takže to často selže, když je příkazovým slovem vestavěný shell nebo uživatelsky definovaná funkce. Předefinováním run-help alias, lze zlepšit on-line nápovědu poskytovanou shellem.

Dále vysvětluje, jak jej nahradit vestavěným vylepšením.

Po nastavení zavolejte na run-help pro názvy vestavěných modulů, dokončovací funkce a tak dále se vám nyní pokusí zobrazit extrahovanou dokumentaci nebo vám zobrazí manuálovou stránku obsahující vpravo atd. Například run-help bindkey výstupy:

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

což by mohlo být lepší. Pro lepší příklad run-help history zobrazuje sekci manuálové stránky Zsh pro fc , což je příkaz, který je základem history .

Je také užitečné poznamenat:ESC-h zavolá run-help pro příkaz na aktuálním vstupním řádku.

Předpokládám, že toto nastavení není výchozí, protože extrahování podrobných dat nápovědy a nastavení HELPDIR ukázat na to může být rozhodnutí o balení ponechané distribucím OS. K dispozici je také uživatelská volba:autoload run-help util je užitečný bez nastavení HELPDIR vůbec. Zdá se, že je dobré přivést vás na správnou manuálovou stránku, i když nemůže přejít na přesnou sekci pro jednu položku. Někteří to mohou dávat přednost před případy, jako je bindkey příklad výše, který jen ztrácí čas. (Proč mají výchozí hodnotu alias run-help=man pak to nedokážu pochopit).

Pro Zsh verze 5.0.3 nebo novější

helpfiles extrakce jsou pravděpodobně součástí distribuce Zsh. Jde jen o to najít je ve vašem systému a nastavit HELPDIR pokud si přejete – pravděpodobní kandidáti jsou v /usr/share/zsh nebo /usr/local/share/zsh , vyhledejte help podadresář.

Pro verze Zsh starší než 5.0.3

Pravděpodobně budete muset postupovat podle postupu popsaného v man zshcontrib soubory nápovědy vygenerujte sami. Je to trochu nepříjemné, že to musíte udělat, ale jinak je to rychlé a bezbolestné.

Najděte nainstalovanou verzi pomocí zsh --version a získejte odpovídající zdrojový tarball z archivu sourceforge. Poté spusťte helpfiles skript, jak je uvedeno v manuálové stránce, a nastavte cíl jako HELPDIR ve vašem ~/.zshrc .