Better documentation of the code

[sbaldu]

The code isn't documented, almost at all. It would be nice to improve this by adding descriptions of header files and classes/methods.