Add command for "documentation fallback" for a class or namespace about doxygen

[albert-github]

• Can you please attach a, small, self contained example (source+configuration file in a, compressed, tar or zip file!) that allows us to reproduce the problem? Please don't add external links as they might not be persistent (also references to GitHub repositories are considered non persistent).
• Please also specify the full doxygen version used (doxygen -v).

[eyalroz]

@albert-github : I can't, because this is not a problem, it's a feature request. But I will attach a couple of source files in which this feature could be used. See edit of first post.

[albert-github]

I can't, because this is not a problem, it's a feature request. But I will attach a couple of source files in which this feature could be used. See edit of first post.

Well you managed to add a nice example to the original post that can be used as a starting point to see what is necessary / wanted.

I looked at the classes example and here I see that the functions bar and quux don't have the same signature as they return a different type of argument (A& and B&). Can't this problem be implemented with templates and sub / super classes?

[eyalroz]

I looked at the classes example and here I see that the functions bar and quux don't have the same signature as they return a different type of argument (A& and B&). Can't this problem be implemented with templates and sub / super classes?

With templates - yes and no, because if A becomes MyClass<0> and B becomes MyClass<1>, specialized differently - the respective methods would still need to return MyClass<0>& and MyClass<1>& respectively; and those are two different return types. Even if one managed to phrase them the same way, e.g. via static constexpr const the_template_argument which gets 0 or respectively 1, and a method returning MyClass<the_teplate_argument> - it's still a different class.

As for using superclasses - that won't help, because then you can't use methods of the subclass, i.e. I want to write something like make_an_A().bar(123).foo() (builder pattern).

I was assuming that name + parameters should be enough for referencing in doxygen (i.e. @ref, @copydoc, @copyparam, etc. etc.)