Re: [Doxygen-users] problem with class hierarchies with templates

[Christoph K. <ko...@in...>]

kri...@ic... said:
> Is anyone interested in this at all except me? 

Emphatically, yes!! I sent Dimitri some related examples quite a long time ago, but
as I understand him template parsing has never been a strong point of Doxygen. Dimitri
has loads of stuff to do and I am afraid that templates are somewhat on a back burner
since they are not heavily used by most developers. The current state of affairs makes
Doxygen (a fine documentation tool [the finest!!!], nevertheless) pretty much unusable
for documenting template-heavy code (like template metaprogramming or expression
template libraries). I was about to propose Doxygen as documentation tool for the
boost (www.boost.org) libraries, but initial tests on several of the boost libraries
showed many of Doxygen's limitations in parsing templates. Perhaps Dimitri can
document somewhere Doxygen's actual template parsing capabilities (like explicit
specialization, partial specialization, default parameters, non-type parameters,
inheritance from template parameters classes or from classes dependent on template
parameters). Another problem is, of course, that class diagrams (such as popularized
by OMT, Booch, UML, you name it) are inherently unable to meaningfully deal with
parameterized classes, at least with C++'s implementation of this concept.

Christoph
-- 
================================================================================
Christoph Koegl, Dept. of Computer Science, University of Kaiserslautern

E-Mail: christoph at familie-koegl dot de
WWW: http://www dot familie-koegl dot de/
--------------------------------------------------------------------------------
There are no stupid questions, but there are a LOT of inquisitive idiots.
--------------------------------------------------------------------------------