ongoing work for the Booklet

 - fixed template (it was the template), adding indentation with Jinja2
 - added description of code examples to man-page template (was missing)
 - fixed fireball, cron, and debug module examples to confrom

- Uses HTML tables and Github-flavored code blocks (3 backticks)

- 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.