Add BUILDOUT_HOME to specify alternate configuration source.

Fix typos.

Use the official, non-version-pinned version.

Fix English speling in README.rst

distutils scripts -- correct order of operations 

distutils scripts -- correct order of operations so 'from ... import' lines are correctly recognized.

Fix test failure due to new setuptools/distribute

Nowadays setuptools always unzips eggs.  Add a renormalizer (one that
was already used for a different test file) so that either zipped or
unzipped setuptools egg is acceptable.

removed documentation about obsoleted 'per section python'

Documentation fix: Mac OS -> Mac OS X and correct short string.

The source code maps `macosx` to `'darwin' in sys_platform`, so this is definitely Mac OS X and not the *old* Mac OS.