Make doxygen-compliant

* Add Doxygen spec file, now generating a Doxygen documentation is
doable by just running `doxygen` in the top level directory
* Fix Doxygen errors and warnings
* Fix whitespace alignment inconsistencies

This is a non-functional change.

Author: vasild