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
|