Library functions and modules should be in the 3 man page section. Also the files should end in '.3'

- Updated man template accordingly
- seem to have left in illegal char in facter DOCUMENTATION...

- notes is now supported
- multiline code examples are now supported (HTML rendering was off)

  - .rst now supresses default if none is set (looks better in HTML)
  - .rst now handles empty options list
  - Fixed postgresql_user and mysql_user because YAML contained colons
  - docs for facter

  plus a small fix in rst.j2 template
  manpages generated & checked
  modules.html generated & checked

Various tweaking to get the module formatter to work for 'make docs' in the docs project.  Likely the templates for other module formatting types will have to change
by the time I'm done.

env-setup now takes a -q argument to run in quiet mode

Refactored hacking/test-module

1. uses optparse

2. has --debugger option

tested only with pdb on Python 2.7

Added code to allow insertion of boilerplate into modules to make them able to share lots of code, the result
should be a huge reduction of total ansible source, at a slight cost of difficulty in original module development.

We need to apply this now to all modules, but may need to have some exemptions to things like command, which should
subclass this module.

Adding a missing '~' to use the user's home directory instead of the root file system for the module arguments

from modules remotely when they fail to parse, and this is VERY useful data.

treated -D as a way to show stderr, and make sure modules don't include things on stderr.
Update docs and test module script to come into line.

It works like this:

{{ hostvars['127.0.0.1']['ansible_eth0']['ipv4']['address'] }}

independent of output, and can also see all the output nicely grouped together if we want
to reformat it or make summaries of statistics.