#4 Code comments missing

[André Offringa]

A lot of code has not been commented at all... We
should start using doxygen or something alike and make
sure at least all public methods have been documented.