[Doxygen-users] Bug? A Class visible in the module page, but it shows undocumented until you assign it a @brief

[Evil K. <evi...@ya...>]

Hi everyone.

I dont know whether this is another bug, but when you add a class to a 
group, it's assigned into the appropriate place in the Modules Page right, 
well, has anyone noticed, if you dont give the class or struct a @brief 
statement, the class isnt available for view, you can't click the classname 
and see the class like you can normally, I Dont know why this is the 
situation, this is a more detailed explanation of my situation and what 
happened

I have a class, I'll rip out the insides and just give the basic information

/**	@class		Entity
  *	@ingroup	Mesh_Graphics_Group
  */
class Entity{
protected:
	/* Blah */
public:
	/* Blah */
};

The groups are defined as such:

/**	@defgroup	Graphics_Group	Graphics Subsystem */

/**	@defgroup	Mesh_Graphics_Group	Mesh Classes
  *	@ingroup	Graphics_Group
  */

Now, when I processed the code with doxygen everything else was fine, 
except for the class above and others like it, adding a @brief statement 
meant they were available, but until then, it was like the class wasnt 
documented or something

/**	@class		Entity
  *	@ingroup	Mesh_Graphics_Group
  *	@brief		A brief explanation
  */
class Entity{
protected:
	/* Blah */
public:
	/* Blah */
};

Now THIS works ok, the only change is the @brief statement

To test the idea about this situation, I went and took out the @brief 
statement I had with a class I knew was documented, as expected, it also 
displayed itself as not documented.  I'm not aware that you MUST HAVE a 
@brief statement, I was under the impression they were additional 
information you COULD add if you wanted to.  SO! Does this qualify as 
another bug?  And yeah yeah, I *could* fix it, but I find the code is kinda 
undocumented (how ironic) and I can't follow it because I simply dont 
understand what it's doing, but thats my fault I think, so the only thing I 
can do is suggest bugs and see what people say

oki doki, guys, ta ta

kosh


_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com