Adding doxygen comments and a new Makefile directive make docs.
You can now generate simple documentation with doxygen.
More documentation forthcoming.