Document the autogen.sh script in the top level of the tree: that is common practise on GitHub.

refs #1198
Rearrange the Python build so we generate object files under the build directory.  Clean up manually: don't rely on setup.py.

refs #1188