[Doxygen-users] C++ templates, class specialization and functions (no member function, nor friend)

[Matthias M. <or...@gm...>]

Hi,

I am using Doxygen with the HTML backend to add documentation to C++
code that use class templates. A function documentation use the \relates
keyword to refer to a class template, called `Matrix<T>'. With the naive
`\relates Matrix<T>', Doxygen complains:

	Warning: Unsupported xml/html tag <T> found

I have found that `\relates Matrix\<T\>' suppress the warning. In both
case the function documentation is in the right place.

Now I'am trying to add documentation to a specialization of the class
template `Matrix<T>'. It works as soon as I use the \relates keyword in
the documentation of a function (not a member function, nor a friend) to
refer to the specialization, called `Matrix<Bit>'. Doxygen complains:

	Warning: Unsupported xml/html tag <Bit> found

and the documentation isn't included to the produced HTML. When I use `
\relates Matrix\<Bit\>' the warning disappear, but the documentation
shows up in the `Matrix<T>' class page...

Am I missing something? Is this a bug?

Is this related to the following excerpt from the Troubleshooting
documentation page: `There is only very limited support for member
specialization at the moment. It only works if there is a specialized
template class as well.'

Thanks for reading! Any help welcome!
-- 
Matthias