doc: generate man page

This commit uses the recent refactoring for defining flags to
automatically generate a man page. This finally allows us to define the
documentation for each flag in a single place.

The man page is generated on every build, if and only if `asciidoc` is
installed. When generated, it is placed in Cargo's `OUT_DIR` directory,
which is the same place that shell completions live.
This commit is contained in:
Andrew Gallant
2018-02-05 18:45:45 -05:00
parent b50ae9a99c
commit 6553940328
8 changed files with 291 additions and 1173 deletions

View File

@@ -11,6 +11,8 @@ addons:
- zsh
# Needed for testing decompression search.
- xz-utils
# For generating man page.
- asciidoc
matrix:
fast_finish: true
include: