doxygen in .h files and make tags

[Steffen Dettmer]

Hi,

here we use doxygen to comment functions in the .h files. When using
"make tags", tags for the definitons but not for the declarations are
generated. In case of "own functions" this is great (you jump to the
implemenations when analysing code) but in other cases it is not and
someone may want to see the documentation.

What best practices exist here?

Steffen