Closes #3992

simplified check_mode
simplified other file attribute handling in link mode
made conditionals clearer

Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

adding a little more info to the 'path' param so it's clear there are aliases (which are used in other examples) to avoid confusion

Breaks recursion parameter on file.

This reverts commit e7226e10.

Signed-off-by: Brian Coca <briancoca+dev@gmail.com>

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