[gettler] 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).

[geierb] moved dropped function definitions into cmyth_deprecated.h and cmyth_local_deprecated.h