auto generated doxygen tags

[RolandHughes]

Does anyone know the reasoning behind filling in \brief with the same class information doxygen generates automatically? Is there a method in QtCreator to override the default contents of this tag?

What am I talking about? Assume we have the following method in a class source file.

void MyClass::methodDoesSomething( int x, double y)
{
...
}

when you place your cursor above the method and type /*! then hit enter you will get a series of doxygen comments auto-generated.

* \brief MyClass::methodDoesSomething
* \param blah
* \param blah

The default value for brief isn't useful. Is this deliberate so it sticks out like a sore thumb in the documentation or is there a manner of overriding the default contents of \brief?

Thanks,

[anda_skoa]

I guess it is the latter since Creator can't really know whether your doxygen config uses the auto-brief mode or not.

Cheers,
_