GNOME Bugzilla – Bug 722654
Inherited member of template class issues warning and is not documented
Last modified: 2016-09-06 20:24:25 UTC
Doxygen 1.8.6 issues warnings about and does not document inherited members of template classes (this did not occur in 1.8.0): /private/var/tmp/doxy_undoc_declaration_test/ERLB.h:8: warning: Member Contains(const Fred *entity) const (function) of class EntityReferenceListBase< Fred > is not documented. Below is a simple example which fails using the auto-generated Doxyfile. ------------------------------ /** This is the base class... */ template <class T> class EntityReferenceListBase { public: inline bool Contains (const T *entity) const; }; template <class T> inline bool EntityReferenceListBase<T>::Contains (const T *entity) const /** This routine determines if an Entity is in a list of Entities. */ { } /** This is the derived class... */ class EntityReferenceList: public EntityReferenceListBase<Fred> { }; }
Note that this works if the member is defined (and documented) in the body of the template class, rather than outside it.
Verified that this does not work in 1.8.7. This is a real problem as it affects most of the documentation of a large project we have.
This still occurs with 1.8.10. Would you mind taking a look at this? Thanks.
Looks to me that this problem has been solved by the last updates in github. I think this bug report can be set to ASSIGNED
Just tried 1.8.11 via git, and the problem is worse. It no longer complains, but the inherited public methods do not appear *at all* now.
Confirmed. Should be fixed in the next GIT update.
Just did a git pull and clean build, and I still get this: /Users/jp/GE/BUGS/1574/ERLB.h:8: warning: Member Contains(const Fred *entity) const (function) of class EntityReferenceListBase< Fred > is not documented. Did I miss something when updating via git?
There has not been an git updated yet (only a pull request has been added to git)
I apologize - I don't use git on a regular basis.
Confirmed that 1.8.12 (git) now fixes the problem - thanks.
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.8.12. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant (preferably in the form of a self-contained example).
Verified - thanks!