Documents Makefile, minor bugfixes

Since I was experimenting with four different interfaces between C++ and
Python (SWIG, boost::python, the Python C API, and Cython), the Makefile
was undergoing constant changes; now that I've settled on Cython, I went
through and documented the various parts of the Makefile, and the config
file (config.mk).