diff options
| author |   Tim Harder <radhermit@gmail.com> | 2015-01-25 10:51:28 -0800 |
|---|---|---|
| committer | Tim Harder <radhermit@gmail.com> | 2015-01-25 10:51:28 -0800 |
| commit | c3373a3503d5486cb8837377e338da664dbec9ac (patch) | |
| tree | a3314c5f5a1a4074cda8870823c6251076ba5901 /.gitignore | |
| parent | use argparse from standard lib (diff) | |
| download | pkgcore-c3373a3503d5486cb8837377e338da664dbec9ac.tar.gz pkgcore-c3373a3503d5486cb8837377e338da664dbec9ac.tar.bz2 pkgcore-c3373a3503d5486cb8837377e338da664dbec9ac.zip | |
doc: first step towards having better man pages
Now we only generate each script's synopsis and options from the related
argparse code instead of generating the whole file. This allows us to
easily add content to the man pages.
Further down the road, we might move away from auto-generated man pages
for scripts entirely and instead rely on generating option and synopsis
dumps that can be compared manually against the current content of a
man page. This is mostly because it would be nice to allow extra
content to be added for various subcommands which in the current
method is tricky without adding lots of extraneous content to the
code.
Diffstat (limited to '.gitignore')
| -rw-r--r-- | .gitignore | 2 |
1 files changed, 0 insertions, 2 deletions
@@ -7,10 +7,8 @@ pkgcore/restrictions/*.so /cache /dist _trial_temp -/man/*.1 /doc/dev-notes/index.rst /doc/dev-notes/*/index.rst /doc/doc/index.rst /doc/_build/ /doc/api/ -/doc/man/ |