raise errors when omitted, updated changelog with new modules.

If src param to copy is a directory, all files under it are collected
and pushed one by one to target. Source dir path handled in a way
simalar to rsync: if it ends with slash, only inside contents of
directory are copied to destination, otherwise the dir itself is
copied (with all contents of course). Original idea and implementation
by https://github.com/ansible/ansible/pull/1809 . Rewritten to address
review comments and simplify/correct logic.

This clarifies the validate command argument and makes it clear that if
it is present, it must include the '%s' argument for the path to the
temporary file to validate.

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

  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

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

step
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>

Ensure that when transferring a file to a directory the name of the file is the correct basename and not 'source'.

Fixes #2388.

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

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.

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

  plus a small fix in rst.j2 template
  manpages generated & checked
  modules.html generated & checked

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

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

uses pid and epoch to prevent collisions, good enough for most cases
Signed-off-by: Brian Coca <briancoca+ansible@gmail.com>