Fixes #6876

directory

Breaks "," values in INI files

This reverts commit af051d6f.

  Migrated all examples: in DOCUMENTATION=''' string to standalone EXAMPLES=''' string
  Added deprecation warning to moduledev.rst and remove deprecated example from it
  Fixed up a few typos and uppercased some acronyms.
  add consistency to how EXAMPLES are formatted

Both modules seboolean and zfs have not been adapted since they defer from the default (either by having a 'null' or special state, or prefering "on"/"off" for state indication.

allow update of default section
add blurb re template to create base file

 - added terse syntax to modules.rst
 - added description of special variables to template module

	testing YAML in YAML: small glitch in rst template; a </pre></p> is outdented and causes messy display

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.

split off examples from DOCUMENTATION into own array as per #1098