Refs #1116: DOCUMENTATION string update

Complete the change from $FILE{} to $FILE()

Allow multiline strings to work okay in only_if

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

Added DOCUMENTATION to supervisorctl module.

Added DOCUMENTATION to pip module.

Added DOCUMENTATION to shell module.

Otherwise, parsing e.g. '$FILE(myfile)'.find("stuff") will include
everything up to the last ) as the filename.

Fixes issue #1137

Fixed error on official docs (reported on DOCUMENTATION string). Name param must be pkg and is required.

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.