Pruebe cualquiera de estos:
man zshbuiltins
o
man zshall
Las páginas man para zsh están divididas por tema, man zsh
es principalmente una tabla de contenido y una introducción, mientras que man zshall
es todo (24628 líneas en mi sistema en comparación con 5242 para man bash
).
En cuanto a bindkey
, man zshbuiltins
lo referirá a man zshzle
.
La información clave para obtener una utilidad de ayuda más útil en realidad se incluye con Zsh, solo es cuestión de encontrar la página de manual crítica y difícilmente detectable:man zshcontrib
(aquí en la web), que describe el run-help
artilugio:
De forma predeterminada, run-help
es un alias para el man
comando, por lo que a menudo falla cuando la palabra de comando es una función interna de shell o definida por el usuario. Al redefinir el run-help
alias, se puede mejorar la ayuda en línea proporcionada por el shell.
Explica además cómo reemplazarlo con una mejora integrada.
Después de configurar esto, llame al run-help
para los nombres de elementos integrados, funciones de finalización, etc. ahora intentará mostrarle la documentación extraída, o mostrarle la página del manual que contiene la derecha, etc. Por ejemplo, run-help bindkey
salidas:
bindkey
See the section `Zle Builtins' in zshzle(1).
que podría ser mejor. Para un mejor ejemplo, run-help history
muestra la sección de la página man de Zsh para fc
, que es el comando que subyace en history
.
También es útil tener en cuenta:ESC-h
llamará run-help
para el comando en la línea de entrada actual.
Supongo que esta configuración no es la predeterminada porque extrajo los datos de ayuda granulares y configuró HELPDIR
señalarlo podría ser una decisión de empaque que se deje a las distribuciones del sistema operativo. También hay una opción de usuario:el autoload run-help
util es útil sin configurar HELPDIR
en absoluto. Parece ser bueno para llevarlo a la página de manual correcta, incluso si no puede saltar a la sección exacta de un elemento. Algunos pueden preferir esto a encontrarse con casos como el bindkey
ejemplo anterior que simplemente hace perder el tiempo. (¿Por qué están predeterminados en alias run-help=man
? entonces, no puedo comprender).
Para Zsh versión 5.0.3 o posterior
El helpfiles
Es probable que las extracciones estén incluidas en la distribución Zsh. Solo es cuestión de encontrarlos en su sistema para configurar HELPDIR
si lo desea, los posibles candidatos están en /usr/share/zsh
o /usr/local/share/zsh
, busca un help
subdirectorio.
Para versiones de Zsh anteriores a la 5.0.3
Es probable que deba seguir el procedimiento detallado en man zshcontrib
usted mismo para generar los archivos de ayuda. Es un poco molesto tener que hacer esto, pero por lo demás es rápido e indoloro.
Encuentra tu versión instalada con zsh --version
y obtenga el tarball fuente correspondiente del archivo sourceforge. Luego ejecuta el helpfiles
script como se muestra en la página del manual y establezca el objetivo como HELPDIR
en tu ~/.zshrc
.