epic doxygen fixes

epic doxygen fixes

It turns out that grouping using @{ and @} only works if it is inside a
doxygen comment like /** */ and not inside a normal comment /* */. This
meant that most of our groupings were incorrect.

- fix @{ and @}
- avoid using /*! which is equivalent to /**
- make some formatting prettier