Doxygen won't index my C++ source - why not?

Question

I have some C++ source code with templates maybe like this - doxygen runs without errors but none of the documentation is added to the output, what is going on?

///
/// A class
///
class A
{
  ///
  /// A typedef
  ///
  typedef B<C<D>> SomeTypedefOfTemplates;
};

Answer 1

Yeah, so what is going on is the template instantiation is bogus. The ">>" like that is ambiguous and is meant to be a compile time error. You couldn't see it because maybe your compiler (VC++) let it slip by but I guess doxygen was stricter on that. Add a space like shown.

///
/// A class
///
class A
{
  ///
  /// A typedef
  ///
  typedef B<C<D> > SomeTypedefOfTemplates;
};

Answer 2

Note that doxygen now supports closing a template with the right shift operator (since version 1.6.0).

Also see http://bugzilla.gnome.org/show%5Fbug.cgi?id=560512 for a discussion on the problem and the solution implemented.