Add some doxygen documentation. A lot was already present.
cc @reznicek @lyubushk
There's another commit that fixes various doxygen warnings in the log.
Note to reviewers. This should not change any executed code.