Added to the file module the functionality to force conversion hard link and symlink when the force attribute is set to 'yes'

This fixes issue #5159.

raise errors when omitted, updated changelog with new modules.

This reverts commit 4d4518ed.

Signed-off-by: Dave Simons <dave@inuits.eu>

For this, add internal "original_basename" param to file module,
similar to copy module. (Param name is a bit misnormer now, should
be treated as "original basepath").

Resolves this issue: https://github.com/ansible/ansible/issues/2067

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.

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>