Sign in to follow this  

Documenting Classes With The Same Name In Doxygen

This topic is 4014 days old which is more than the 365 day threshold we allow for new replies. Please post a new topic.

If you intended to correct an error in the post then please contact us.

Recommended Posts

Hello I have two classes with the same name, but they are in different name spaces. I want to document them both with Doxygen, as they are based on different template parameters and behave differently. Doxygen complains that it has found a description for the class somewhere else (which it technically has), so it doesn't document both versions. Does anyone have an idea of how to persuade Doxygen to document them both, and list them both in the same module? Thanks in advance Spree.

Share this post


Link to post
Share on other sites
I have never had a problem, as long as I place the comment block directly before the class declration in question and don't refer to the class name directly. It seems Doxygen will do the right thing by default most of the time.

File names, on the other hand, sometimes need qualification in the @file (or \file) entry.

Share this post


Link to post
Share on other sites
The Doxygen comments for both classes are directly above each class definition, and within the respective namespaces.

I can't remember the exact error (I'm at home now), but it states something along the lines of
"Documentation found for class stack at [File Location]. Ignoring documentation at [Different File Location].

All the documentation for the class methods are within the class, above the method declarations (and definition, since it is a template class), so I don't know how to get the code any nearer to the actual class than it actually is.

Spree

Share this post


Link to post
Share on other sites

This topic is 4014 days old which is more than the 365 day threshold we allow for new replies. Please post a new topic.

If you intended to correct an error in the post then please contact us.

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now

Sign in to follow this