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

Make pep8 tests run against the library directory as well, and associated tweaks (mostly to indentation) in the library
directory.

whitespace + remove deprecated YAML parser (migration script lives in examples/scripts and warning was added
in 0.6 release)

Add encoding lines to python modules such that they can take unicode options if they are fed them, since the
AnsibleModule stuff no longer base64 encodes for simplicity and speed reasons.

This will ensure users of previous versions of this module don't
have their playbooks break.

the apt module to use it

The apt parameter changed from update-cache to update_cache, but
the error message still mentioned update-cache

1. Passing the module to the various functions so that they can use module.fail_json and module.exit_json methods inside.
2. Because of point 1, install and remove methods do not return anything. Instead, they use the module functions itself.
3. Move the import statement (for apt and apt_pkg) inside main function so on import error, we can use module.fail_json to print the error.

Getting the apt module to accept and understand a 'install-recommends' parameter which allows running apt with --no-install-recommends

The ohai and facter modules use /usr/bin/logger to log the fact that
they have been invoked.  I added 'import os' to the ping module
so that it could have the same syslog statements as the other modules.
I separated the condensed:
    shlex.split(open(argfile, 'r').read())
into two separate statements similar to the other modules.

treated -D as a way to show stderr, and make sure modules don't include things on stderr.
Update docs and test module script to come into line.

The value is passed to apt-get's "-t" option. Useful for installing backports, e.g.:

  ansible webservers -m apt -a "pkg=nginx state=latest default-release=squeeze-backports"

This uses standard APT syntax, e.g.:

    ansible webservers -m apt -a "pkg=nginx=1.1.19-1 state=installed"