ansible/docs/templates
Adrian Likins 89c973445c generate rst doc pages for command line tools (#27530)
* let generate_man also gen rst pages for cli tools
* make template-file, output-dir, output format cli options for generate_man
* update main Makefile to use generate_man.py for docs (man pages and rst)
* update vault docs that use :option:
* Edits based on
6e34ea6242 and
a3afc78535

* add a optparse 'desc' to lib/ansible/cli/config.py 

  The man page needs a short desc for the 'NAME' field
  which it gets from the option parse 'desc' value.

  Fixes building ansible-config man page.

* add trim_docstring from pep257 to generate_man

  use pep258 docstring trim function to fix up any indention
  weirdness inherit to doc strings (ie, lines other than
  first line being indented.

* Add refs to cli command actions

To reference ansible-vaults --vault-id option, use:

:option:`The link text here <ansible-vault --vault-id>`

or:

:option:`--vault-id <ansible-vault --vault-id>`

To reference ansible-vault's 'encrypt' action, use:

:ref:`The link text here <ansible_vault_encrypt>`

or most of the time:

:ref:`ansible-vault encrypt <ansible_vault_encrypt>`
2017-09-07 15:44:20 -04:00
..
cli_rst.j2 generate rst doc pages for command line tools (#27530) 2017-09-07 15:44:20 -04:00
config.rst.j2 Add ANSIBLE_CONFIG envvar to config/envvars tmpl (#28886) 2017-09-01 14:53:42 -07:00
list_of_CATEGORY_modules.rst.j2 Misc docs fixes 2017-08-22 11:52:30 -07:00
man.j2 generate rst doc pages for command line tools (#27530) 2017-09-07 15:44:20 -04:00
modules_by_category.rst.j2 Revamp the plugin_formatter doc generator 2017-08-15 23:12:08 -07:00
modules_by_support.rst.j2 Misc docs fixes 2017-08-22 11:52:30 -07:00
playbooks_keywords.rst.j2 added docs to CLI docstringsadded 2017-03-24 15:52:36 -04:00
plugin.rst.j2 Misc docs fixes 2017-08-22 11:52:30 -07:00