Doxygen references inside a template class inside a namespace - doxygen

Question

In the following minimal example, I have a template class in a namespace. The description of each member refers to another member.
/// #brief My namespace
namespace template_test
{
template <int param_v>
class TemplateClass
{
public:
/// #brief \ref template_test::TemplateClass::func2() <- OK
int func1() { return 1; }
/// #brief \ref func1() <- unable to resolve
int func2() { return 2; }
};
class InstanceClass
{
TemplateClass<5> m_templ_class;
};
} // namespace template_test
At this example, I get the error
unable to resolve reference to 'func1()' for \ref command
One possible solution would be to always reference to entire signature including the namespace template_test::TemplateClass::... like at func1(). But I find this quite confusing and if you change the namespace once, you have to refactor the entire documentation.
I am particularly surprised by the following observations:
It works without problems if the template class is in the main namespace.
template <int param_v>
class TemplateClass
{
public:
/// #brief \ref func2() <- OK
int func1() { return 1; }
/// #brief \ref func1() <- OK
int func2() { return 2; }
};
/// #brief My namespace
namespace template_test
{
class InstanceClass
{
TemplateClass<5> m_templ_class;
};
} // namespace template_test
It works without problems if no template is used.
/// #brief My namespace
namespace test
{
class NoTemplateClass
{
public:
/// #brief \ref func2() <- OK
int func1() { return 1; }
/// #brief \ref func1() <- OK
int func2() { return 2; }
};
class InstanceClass
{
NoTemplateClass m_no_templ_class;
};
} // namespace test
How does this particular behavior occur when a template class is inside a namespace?
Is there an easier way than specifying namespace and class name for each reference?
Regarding this posting, EXTRACT_ALL is set to YES.
ETA:
As soon as I remove the
class InstanceClass
{
TemplateClass<5> m_templ_class;
};
it's possible to create the links to both functions within the TemplateClass.
Difference with default Doxyfile
# Difference with default Doxyfile 1.9.5 (2f6875a5ca481a69a6f32650c77a667f87d25e88)
PROJECT_NAME = ${PROJECT_NAME}
OUTPUT_DIRECTORY = ${DOCS_OUTPUT_DIRECTORY}
STRIP_FROM_PATH = ${PROJECT_SOURCE_DIR}
TOC_INCLUDE_HEADINGS = 0
EXTRACT_ALL = YES
EXTRACT_PRIVATE = YES
EXTRACT_STATIC = YES
CASE_SENSE_NAMES = YES
SORT_MEMBER_DOCS = NO
WARN_AS_ERROR = YES
WARN_LOGFILE = ${DOXYGEN_WARN_LOG_FILE}
INPUT = ${INPUTS}
FILE_PATTERNS = ${FILE_PATTERNS}
RECURSIVE = YES
EXCLUDE_PATTERNS = *.txt
EXAMPLE_RECURSIVE = YES
HTML_OUTPUT = _doxygen
HTML_EXTRA_STYLESHEET = ${SOURCE_DIR}/tools/doxygen/doxygen-awesome.css
USE_MATHJAX = YES
MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
MATHJAX_EXTENSIONS = TeX/AMSmath \
TeX/AMSsymbols
SEARCHENGINE = NO
GENERATE_LATEX = NO
LATEX_CMD_NAME = latex
XML_OUTPUT = _doxygen/xml
MACRO_EXPANSION = YES
PREDEFINED = TSM_USE_VFC_UNITS
DIRECTORY_GRAPH = NO
DOT_IMAGE_FORMAT = svg
INTERACTIVE_SVG = YES
DOTFILE_DIRS = .
PLANTUML_JAR_PATH = /usr/share/plantuml/plantuml.jar
DOT_GRAPH_MAX_NODES = 350

Answer 1

As Albert wrote in the comments, it works without warning/error with Doxygen version 1.9.6. In this respect, this is the actual solution to the problem.