[Doxygen-users] Don't use @class <blah>

[Jan R. <ja...@mo...>]

> -----Original Message-----
> From: Glenn Maxey [mailto:gle...@vo...]
> Sent: Monday, February 25, 2002 7:42 AM
> To: Evil Kosh; Doxygen Mailing list
> Subject: RE: [Doxygen-users] Formatting groups within "Class 
> Hierarchy"
> page
> 
> 
> Just a few points:
> 
> [1] Don't use @class <blah> unless that doxygen comment is 
> separate from
> the owning code item. If the doxygen comment is immediately 
> in front of
> the owning code item, you can start right away with @brief or 
> whatever.

I use //! \class blah blah.h dir/blah.h

for the sole purpose of getting the proper include path (dir/blah.h rather
than just blah.h) in the docs. Is there another (better) way to get this
behavior? Note that even if blah.h was actually in a subdirectory relative
to where Doxygen was run from, Doxygen still strips away the directory name,
so I have to put it back in by hand in docs. Am I missing a config flag to
get the behavior I want?

Thanks
JR