ez_setup.py now takes a --insecure argument to bypass the secure downloaders. download_setuptools also now accepts a new keyword argument 'download_factory', enabling programmitic invocation to customize the downloader resolution. Fixes #75. Thanks to Pablo Algarvio for the report and suggestions.

Document __main__.__requires__

--HG--
branch : docs_update_for_requires

--HG--
branch : docs_update_for_requires

Updated error message reported when `--allow-hosts` blocks a link to provide a less startling user experience. Fixes #71.

Also modernises the initial overview for pkg_resources, and helps
make it clear that it covers anything with an egg-info directory,
not just egg files.

--HG--
branch : docs_update_for_requires