Use common file argument system previously implemented by @sivel for rax modules on the file modules as well (copy/file/template).
Application to other cloud providers would make very good sense.

passed via this paramter is not passed via shell and so all shell features
will not work.

"resort" -> "result"

used)

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

raise errors when omitted, updated changelog with new modules.

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

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.

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>

Signed-off-by: Brian Coca <bcoca@tablethotels.com>

Added two additional template variables
* template_fullpath - absolute path to the template
* template_run_date - date that the template was rendered
Documented these additional variables in the module documentation

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

Setup module no longer saves to disk, as templates are mostly useful in playbooks and this allows lots of simplifications
around file pathing and removes occasional permissions conflicts depending on how things are used.

Python 2.4 (RHEL 5) does not know 'as'.

module so that if a directory path is specified we get valid output

all modules take a common parameter name.  But more or less we still work idempotently
in modules.