Doxygen comments on declarations or on definitions?
- by Arkaitz Jimenez
Just started using Doxygen for documenting my code here and can't decide where to put them.
At first look it seems better to put them in the declaration files as it is there where you actually declare what you receive, what you are going to return and stuff like that, apart from that things like data members that are only in the declaration files can obviously only documented there.
But often I find handier to comment methods in the implementation files as they are more accessible to me and the declaration file doesn't get cluttered with dozens of lines of comments making it harder to find what you look for when developing.
What is your experience with that?