zsh helpfully comes installed with help files for all the builtins and a
run-help command to help you access those help files. There is a trick though, before setting any environment variables here’s what happens:
$ run-help There is no list of special help topics available at this time.
This is because the
HELPDIR isn’t set. You have to find the install location for zsh’s help files and set the env var to that dir. On my system that looks like this:
Then when you run
run-help you should see a list of builtins for which there is help documentation. This is the same documentation that you can get via
man builtins but much more readable and discoverable.
run-help will call
man as well if it can’t find you’re arg in the help files.
run-help is cumbersome to type so I alias it. Here’s what goes into my
export HELPDIR='/usr/share/zsh/help' alias help=run-help
zsh is now much more helpful!