Lots of (mostly) documentation changes to improve the internal and external
API documentation generated by doxygen.  Also marked a whole bunch of
functions as deprecated or unimplemented to give guidance to users and
developers about how the API may change in future versions (ie, 0.2.x).