Doxygen documentation.

[kmactavish]

It would be nice to have the code (at least the public API) documented with Doxygen.

This work is in progress (will come across in a later pull request).

[arrenglover]

agree, having doxygen comments would be great. Where possible the current API documentation can be converted to doxygen.