Fixed the example.

Changed shebangs that use /usr/bin/env to use /usr/bin/python and therefore be compatible with the ansible_python_interpreter variable.

Adds more parameters which may be passed to supervisorctl:  config,
serverurl, username, password

Also refactored the various `module.run_command(build_a_string)` calls
into a single `run_supervisorctl` function.

Add a new module for managing entries in an htpasswd file, used
for basic authentication with web servers such as Apache and Nginx

The django 'migrate' command should receive the --noinput command,
otherwise it can block waiting for user input.

Signed-off-by: Jochen Maes <jochen@sejo-it.be>

  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