19 lines
1.3 KiB
Markdown
19 lines
1.3 KiB
Markdown
# Code documentation
|
||
|
||
Here is `Asciidoc` code documentation generated using [Zshelldoc](https://github.com/zdharma/zshelldoc).
|
||
There are `4` Zplugin's source files, the main one is [zplugin.zsh](zplugin.zsh.adoc). The documentation
|
||
lists all functions, interactions between them, their comments and features used.
|
||
|
||
Github allows to directly view `Asciidoc` documents:
|
||
* [zplugin.zsh](zplugin.zsh.adoc) – always loaded, in `.zshrc` ([pdf](http://zdharma.org/zplugin/zplugin.zsh.pdf))
|
||
* [zplugin-side.zsh](zplugin-side.zsh.adoc) – common functions, loaded by `*-install` and `*-autoload` scripts ([pdf](http://zdharma.org/zplugin/zplugin-side.zsh.pdf))
|
||
* [zplugin-install.zsh](zplugin-install.zsh.adoc) – functions used only when installing a plugin or snippet ([pdf](http://zdharma.org/zplugin/zplugin-install.zsh.pdf))
|
||
* [zplugin-autoload.zsh](zplugin-autoload.zsh.adoc) – functions used only in interactive `Zplugin` invocations ([pdf](http://zdharma.org/zplugin/zplugin-autoload.zsh.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).
|