ansible/ansible — pull request #1101 by jpmens (2012-09-26 18:47:42+00:00)
Title: Module DOCUMENTATION formatter

OK, here goes:

1. I'm not able to extract strings from `EXAMPLES = []`. Please **help**. Templates for `man` and `rst` use _examples_ in DOCUMENTATION dict for the time being.
2. `Makefile` for ansible augmented with target `manpages`: it uses the
formatter to create manuals (one example in `docs/man/man1/ansible.lineinfile.man`).
3. rST template (`hacking/templates/rst.j2`) is a mess, but it works.
1. I don't know how to import HTML into rST, but maybe it doesn't matter, because
2. I'm creating tables as [simple tables](http://sphinx.pocoo.org/rest.html#tables). Looks
ok to me ...
4. Directories `ansible` and `ansible-docs` must be on same level.
5. I've modified `Makefile` in `ansible-docs` with a _modules_ target which invokes the formatter

See also: https://github.com/ansible/ansible-docs/pull/4