Geoff Worboys writes:
> Sam Varshavchik wrote:
> > I'm not overriding or redefining the inherited methods in the
> > subclass. So, having the inherited methods documented isn't
> > really a big deal; just suppressing warnings for imported,
> > and undocumented, stuff would also be fine.
>
> > Or, one hack would be for doxygen to generate a link to the
> > supeclass's methods, when a subclass inherits methods from a
> > class that's imported, just to a \see parent::method in lieu
> > of missing documentation.
>
> I agree with your assessment. (Is it safe to assume that you
> have tried setting INHERIT_DOCS=3DNO and that that does get rid
> of the warnings?)
I must admit that I haven't, I was guessing. And I thought that it was a
pretty good guess, but turning inheritance off made no difference, so that
wasn't it.
However, I have a reproducible test case that demonstrates this, using a
pair of minimal doxyfiles.
Running doxygen in the proj1 subdirectory creates a tagfile for one header
file. Then, running doxygen in the proj2 subdirectory issues the strange
warning for <unknown>:1, referencing the sole method in the header file
(amidst the verbosity out of the default, loud, Doxyfile):
[mrsam@monster proj]$ cat proj1/Doxyfile
FILE_PATTERNS = *.H
GENERATE_TAGFILE = tagfile.tag
[mrsam@monster proj]$ cat proj1/vector.H
//! Template class
template<typename T>
class vector {
public:
//! Member
void load()
{
}
};
[mrsam@monster proj]$ cat proj2/Doxyfile
FILE_PATTERNS = *.H
TAGFILES = ../proj1/tagfile.tag=../proj1
[mrsam@monster proj]$ cat proj2/user.H
#include "../proj1/vector.H"
//! Derived
class derived : public vector<int> {
};
------------------------------------------------------------------------------
How ServiceNow helps IT people transform IT departments:
1. A cloud service to automate IT design, transition and operations
2. Dashboards that offer high-level views of enterprise services
3. A single system of record for all IT processes
http://p.sf.net/sfu/servicenow-d2d-j
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
