Raise AnsibleError if $FILE() or $PIPE() fail

Added DOCUMENTATION to supervisorctl module.

Added DOCUMENTATION to pip module.

Added DOCUMENTATION to shell module.

Setting trim_blocks to True

Removed embedded colon in DOCUMENTATION of apt_repository

removed EXAMPLES from ini_file

module DOCUMENTATION for apt, apt_respository cleanup

	testing YAML in YAML: small glitch in rst template; a </pre></p> is outdented and causes messy display

Added documentation to APT module

Fix to make sure only strings are being joined

Module DOCUMENTATION for template, wait_for, and yum

Module DOCUMENTATION: assemble, authorized_key, command, copy

Close zeromq context and socket.

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

Since BOOLEANS also contains integers, joining the list returns an error. Easy to test by giving a wrong value to a boolean argument:

    service name=httpd enabled=True

Since True is not in the allowed BOOLEANS, it will cause the error, which in its turn bails out because it joins strings and integers.
We may want to remove the integers from the choices since '0' and '1' are already in the list as strings. Personally I would expect only strings as arguments, not sure where these could be integers ??

module_formatter fixes

Revert pull request #1091

Automatic quoting of variables in only_if breaks existing playbooks
where entire statements are put in a variable, and other cases. See
issue #1120 for details.

Various tweaking to get the module formatter to work for 'make docs' in the docs project.  Likely the templates for other module formatting types will have to change
by the time I'm done.