The order of \class and \ingroup seems to make a difference on output:
/**
\class Foo1
\ingroup blabla
Class that does something of no interest.
*/
/**
\ingroup blabla
\class Foo2
Class that doesn't do anything useful.
*/
If you generate the documentation and then go to the "blabla" module
page, you see:
class Foo1
class Foo2
Foo2 is an abstract base class for windowing. [More...]
The brief description (here the first sentence of doc block) does not
show for Foo1 whereas it does for Foo2, this doesn't seem to make sense.
Also, the brief description showing for Foo2 is sort of handy, but the
[More] hyperlink is just extra clutter since Foo2 is already hyperlinked
to its docs.
I've notice same problem with \file vs \ingroup. Are these bugs?
Oliver
|
