Correct comment badly interpreted by doxygen.
Add some missing doc + reformatting.
Add some missing doc + reformatting.