dotfiles/dot_zinit/bin/zsdoc

Code documentation

Here is Asciidoc code documentation generated using Zshelldoc. There are 4 Zplugin's source files, the main one is zplugin.zsh. The documentation lists all functions, interactions between them, their comments and features used.

Github allows to directly view Asciidoc documents:

• zplugin.zsh – always loaded, in .zshrc (pdf)
• zplugin-side.zsh – common functions, loaded by *-install and *-autoload scripts (pdf)
• zplugin-install.zsh – functions used only when installing a plugin or snippet (pdf)
• zplugin-autoload.zsh – functions used only in interactive Zplugin invocations (pdf)

PDFs, man pages, etc.

Formats other than Asciidoc can be produced by using provided Makefile. For example, issuing make pdf will create and populate a new directory pdf (requires asciidoctor, install with gem install asciidoctor-pdf --pre). make man will create man pages (requires package asciidoc, uses its command a2x, which is quite slow).