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,
Bookmarks