Breaks recursion parameter on file.

This reverts commit e7226e10.

The file module would in some cases return dest=/path/to/file, and in other cases return path=/path/to/file, this change makes it more consistent and in line with all the other file-related modules (i.e. copy, assemble, template, ...) by using dest= instead of path= as the input and output argument. (Of course, path is still there as an alias for compatibility).

	remove obsolete examples: key

added force parameter to symlink invocation, in order to force the creation in case of already existing destination with the type of 'file'

  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

Also a bit nicer now with failures
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

Added 'validate' feature to copy and template modules, now you can add a check to force copy to fail if the check fails.
had to add entry in file for it to accept as a option even though file itself ignores it.
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

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.

This implements a basic --check mode which for now is only implemented on template & copy operations.  More detail will be shared with the list
shortly.

Two problems here
* unchecked exception handling and erroneous assumption as to why
  an exception might fire
* although the file module expands the path, when using file_args
  the unexpanded path is passed.

Expected result: ~/path/to/file should work fine
Actual result: exception is because it doesn't find file with a message
about not being able to get the selinux context

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

Various performance streamlining and making the file features usable in all modules without daisy chaining.

implement lookup plugins for arbitrary enumeration over arbitrary things.   See the mailing list for some cool examples.

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.