doxygen comments should always be at the declaration (i.e. in the header).