Breaks recursion parameter on file.

This reverts commit e7226e10.

Add follow parameter to stat module that controls whether to follow
symlinks.  It defaults to no.
This then calls os.stat or os.lstat based on the value of follow.
Add lnk_source key/value pair if path is a symlink and follow=no.
Drop the statement that sets isdir=False and islnk=True when path is a
symlink that points to a directory.

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

Breaks "," values in INI files

This reverts commit af051d6f.

  remove unnecessary import,
  md5 sum on regular files only

	remove obsolete examples: key

visudo requires the -f option to check any other file than the default.
I've added this to the example ansible tasks.

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>

Change a lineinfile example from /etc/host to /etc/hosts

Modified assemble module so the dest file is streamed together rather than built-in memory before writing.

And also be liberal in what ansible-doc accepts as an empty
requirements specification.

While here fix a typo in template module documentation
wrt jinja2 overrides example.

instead of writing directly to original
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

removed return code as it doesn't make sense anymore
Signed-off-by: Brian Coca <briancoca+dev@gmail.com>