mad(1) is a markdown driven manual page viewer,
this makes manuals easier to write, reuse, and
Usage: mad <file> Options: -U, --update-self update mad(1) itself -u, --update update remote mad-pages -v, --version output cpm version -h, --help output this help information -l, --list list mad-pages
mad(1) and its associated mad page.
$ make install
mad(1) and the associated mad page.
$ make uninstall
I love man pages, however they are annoying to write by hand,
and often converted from markdown anyway.
mad(1) is effectively
the same idea, but write your manuals in markdown like you would anyway,
re-use them in your github readmes, wikis, or use markdown to HTML conversion
mad(1) pipes to
less(1) so you get the same paging / searching
goodness that you expect from
mad-pages is a collection of
useful mad pages such as language operator precedence tables, http status
codes, mime type tables etc. Use
mad --update to install/re-install them.
Use the MAD_PATH environment variable to control
mad(1) will look for a manual page.
The ".md" extension may be omitted.
The following paths will always be searched:
- . - /usr/local/share/mad - /usr/share/mad
mad(1) installs and sources
/usr/local/etc/mad.conf for its formatting. You may edit this file directly, or if you're scared of overwriting it
mad(1) you can copy this file to something like
heading: 1m code: 90m strong: 1m em: 4m