Add variadic template function regression tests

* testing/069_link_variadic_template.cpp: new file, @link regression
  test for variadic template function
* testing/069/069__link__variadic__template_8cpp.xml: new file, expected
  @link regression test result for variadic template function
* testing/070_ref_variadic_template.cpp: new file, @ref regression
  test for variadic template function
* testing/070/070__ref__variadic__template_8cpp.xml: new file, expected
  @ref regression test result for variadic template function

At the time of writing, the part between <> is totally ignored:
func<Args...>(Args... args) is interpreted as func(Args... args).

Beware that a function parameter with either a & or * operator, e.g.
'const Args&... args', requires @link and @ref to use such parameter
as verbatim, i.e. {@link func(const Args&... args)}.  At the time of
writing, the form {@link func(const Args&...)} will fail, unless the
function parameter was declared just as 'const Args&...'.

4 files changed, 808 insertions, 0 deletions

diff --git a/testing/069/069__link__variadic__template_8cpp.xml b/testing/069/069__link__variadic__template_8cpp.xml
new file mode 100644
index 0000000..c93a732
--- /dev/null
+++ b/testing/069/069__link__variadic__template_8cpp.xml
@@ -0,0 +1,309 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<doxygen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="compound.xsd" version="">
+  <compounddef id="069__link__variadic__template_8cpp" kind="file" language="C++">
+    <compoundname>069_link_variadic_template.cpp</compoundname>
+    <innerclass refid="class_test" prot="public">Test</innerclass>
+    <sectiondef kind="func">
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1affb6da6cff1b57cdf8efc0123dceac9b" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A function </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="40" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1aa7e4936a17759246bce60256cf224e16" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args &amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args &amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="45" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1ad6fc2d2a6cb8980f3e0eaacbd2ae41fe" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args &amp;&amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args &amp;&amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="50" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args &amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args &amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="55" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1aed64c596fea5f4f5e719006539922f7c" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args &amp;&amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args &amp;&amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="60" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1a0ad18d95a1dc2dbacee657c43f719187" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args *... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args *...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="65" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1a2331eedd0a1db9da5de0ad0faef78a4e" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args **... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args **...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="70" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1a72bd94e61df947347f98a2a6214e9342" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args *... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args *...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="75" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1a0bd03c39aa36ae51d2b8d87e04cf7eab" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args **... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args **...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="80" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="069__link__variadic__template_8cpp_1abb1e0338f72ae46a1240ada65d6a397c" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="069_link_variadic_template.cpp" line="85" column="1"/>
+      </memberdef>
+    </sectiondef>
+    <briefdescription>
+    </briefdescription>
+    <detaileddescription>
+      <para>
+        <simplesect kind="attention">
+          <para>
+            <parblock>
+              <para>At the time of writing, the part between &lt;&gt; is totally ignored: func&lt;Args...&gt;(Args... args) is interpreted as func(Args... args).</para>
+              <para>Beware that a function parameter with either a &amp; or * operator, e.g. 'const Args&amp;... args', requires \link and \ref to specify such parameter as verbatim, i.e. 'const Args&amp;... args'. At the time of writing, the form func(const Args&amp;...) will fail, unless the function parameter was declared just as 'const Args&amp;...'. </para>
+            </parblock>
+          </para>
+        </simplesect>
+      </para>
+      <para>
+        <ref refid="class_test_1a64d85df31d518e39726467315a9b05e3" kindref="member">variadic template method</ref>
+      </para>
+      <para>Links to the variadic template function overloads: <itemizedlist><listitem><para><ref refid="069__link__variadic__template_8cpp_1aa7e4936a17759246bce60256cf224e16" kindref="member">First overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1ad6fc2d2a6cb8980f3e0eaacbd2ae41fe" kindref="member">Second overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" kindref="member">Third overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1aed64c596fea5f4f5e719006539922f7c" kindref="member">Fourth overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1a0ad18d95a1dc2dbacee657c43f719187" kindref="member">Fifth overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1a2331eedd0a1db9da5de0ad0faef78a4e" kindref="member">Sixth overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1a72bd94e61df947347f98a2a6214e9342" kindref="member">Seventh overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1a0bd03c39aa36ae51d2b8d87e04cf7eab" kindref="member">Eighth overload</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1abb1e0338f72ae46a1240ada65d6a397c" kindref="member">Ninth overload</ref></para></listitem></itemizedlist>
+The followings are interpreted the same: <itemizedlist><listitem><para><ref refid="069__link__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" kindref="member">without template argument</ref></para></listitem><listitem><para><ref refid="069__link__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" kindref="member">with template argument</ref></para></listitem></itemizedlist>
+See the <ref refid="class_test" kindref="compound">test</ref> class. </para>
+    </detaileddescription>
+    <location file="069_link_variadic_template.cpp"/>
+  </compounddef>
+</doxygen>
diff --git a/testing/069_link_variadic_template.cpp b/testing/069_link_variadic_template.cpp
new file mode 100644
index 0000000..89ab57c
--- /dev/null
+++ b/testing/069_link_variadic_template.cpp
@@ -0,0 +1,95 @@
+// objective: test \link command with a variadic template function
+// check: 069__link__variadic__template_8cpp.xml
+
+/** \file
+ *
+ *  @attention
+ *  @parblock
+ *  At the time of writing, the part between \<\> is totally ignored:
+ *  %func<Args...>(Args... args) is interpreted as %func(Args... args).
+ *
+ *  Beware that a function parameter with either a \& or \* operator,
+ *  e.g. 'const Args&... args', requires \\link and \\ref to specify
+ *  such parameter as verbatim, i.e. 'const Args&... args'.  At the
+ *  time of writing, the form %func(const Args&...) will fail, unless
+ *  the function parameter was declared just as 'const Args&...'.
+ *  @endparblock
+ *
+ *  \link Test::func(int,Args...)const variadic template method\endlink
+ *
+ *  Links to the variadic template function overloads:
+ *    @li \link func(int,Args&... args) First overload\endlink
+ *    @li \link func(int,Args&&... args) Second overload\endlink
+ *    @li \link func(int,const Args&... args) Third overload\endlink
+ *    @li \link func(int,const Args&&... args) Fourth overload\endlink
+ *    @li \link func(int,Args*... args) Fifth overload\endlink
+ *    @li \link func(int,Args**... args) Sixth overload\endlink
+ *    @li \link func(int,const Args*... args) Seventh overload\endlink
+ *    @li \link func(int,const Args**... args) Eighth overload\endlink
+ *    @li \link func(int,Args...) Ninth overload\endlink
+ *
+ *  The followings are interpreted the same:
+ *    @li \link func(int,const Args&... args) without template argument\endlink
+ *    @li \link func<Args...>(int,const Args&... args) with template argument\endlink
+ *
+ *  See the \link Test test\endlink class.
+ */
+
+/** A function
+ */
+void func(int p);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args&&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args&&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args*... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args**... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args*... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args**... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args... args);
+
+/** A test */
+class Test
+{
+ public:
+  /** A variadic template method
+   */
+  template <typename... Args>
+  void func(int p, Args... args) const;
+};
diff --git a/testing/070/070__ref__variadic__template_8cpp.xml b/testing/070/070__ref__variadic__template_8cpp.xml
new file mode 100644
index 0000000..0f581e5
--- /dev/null
+++ b/testing/070/070__ref__variadic__template_8cpp.xml
@@ -0,0 +1,309 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<doxygen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="compound.xsd" version="">
+  <compounddef id="070__ref__variadic__template_8cpp" kind="file" language="C++">
+    <compoundname>070_ref_variadic_template.cpp</compoundname>
+    <innerclass refid="class_test" prot="public">Test</innerclass>
+    <sectiondef kind="func">
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1affb6da6cff1b57cdf8efc0123dceac9b" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A function </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="40" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1aa7e4936a17759246bce60256cf224e16" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args &amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args &amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="45" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1ad6fc2d2a6cb8980f3e0eaacbd2ae41fe" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args &amp;&amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args &amp;&amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="50" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args &amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args &amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="55" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1aed64c596fea5f4f5e719006539922f7c" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args &amp;&amp;... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args &amp;&amp;...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="60" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1a0ad18d95a1dc2dbacee657c43f719187" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args *... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args *...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="65" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1a2331eedd0a1db9da5de0ad0faef78a4e" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args **... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args **...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="70" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1a72bd94e61df947347f98a2a6214e9342" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args *... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args *...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="75" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1a0bd03c39aa36ae51d2b8d87e04cf7eab" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, const Args **... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>const Args **...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="80" column="1"/>
+      </memberdef>
+      <memberdef kind="function" id="070__ref__variadic__template_8cpp_1abb1e0338f72ae46a1240ada65d6a397c" prot="public" static="no" const="no" explicit="no" inline="no" virt="non-virtual">
+        <templateparamlist>
+          <param>
+            <type>typename...</type>
+            <declname>Args</declname>
+            <defname>Args</defname>
+          </param>
+        </templateparamlist>
+        <type>void</type>
+        <definition>void func</definition>
+        <argsstring>(int p, Args... args)</argsstring>
+        <name>func</name>
+        <param>
+          <type>int</type>
+          <declname>p</declname>
+        </param>
+        <param>
+          <type>Args...</type>
+          <declname>args</declname>
+        </param>
+        <briefdescription>
+        </briefdescription>
+        <detaileddescription>
+          <para>A variadic template function overload </para>
+        </detaileddescription>
+        <inbodydescription>
+        </inbodydescription>
+        <location file="070_ref_variadic_template.cpp" line="85" column="1"/>
+      </memberdef>
+    </sectiondef>
+    <briefdescription>
+    </briefdescription>
+    <detaileddescription>
+      <para>
+        <simplesect kind="attention">
+          <para>
+            <parblock>
+              <para>At the time of writing, the part between &lt;&gt; is totally ignored: func&lt;Args...&gt;(Args... args) is interpreted as func(Args... args).</para>
+              <para>Beware that a function parameter with either a &amp; or * operator, e.g. 'const Args&amp;... args', requires \link and \ref to specify such parameter as verbatim, i.e. 'const Args&amp;... args'. At the time of writing, the form func(const Args&amp;...) will fail, unless the function parameter was declared just as 'const Args&amp;...'. </para>
+            </parblock>
+          </para>
+        </simplesect>
+      </para>
+      <para>
+        <ref refid="class_test_1a64d85df31d518e39726467315a9b05e3" kindref="member">variadic template method</ref>
+      </para>
+      <para>References to the variadic template function overloads: <itemizedlist><listitem><para><ref refid="070__ref__variadic__template_8cpp_1aa7e4936a17759246bce60256cf224e16" kindref="member">First overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1ad6fc2d2a6cb8980f3e0eaacbd2ae41fe" kindref="member">Second overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" kindref="member">Third overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1aed64c596fea5f4f5e719006539922f7c" kindref="member">Fourth overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a0ad18d95a1dc2dbacee657c43f719187" kindref="member">Fifth overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a2331eedd0a1db9da5de0ad0faef78a4e" kindref="member">Sixth overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a72bd94e61df947347f98a2a6214e9342" kindref="member">Seventh overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a0bd03c39aa36ae51d2b8d87e04cf7eab" kindref="member">Eighth overload</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1abb1e0338f72ae46a1240ada65d6a397c" kindref="member">Ninth overload</ref></para></listitem></itemizedlist>
+The followings are interpreted the same: <itemizedlist><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" kindref="member">without template argument</ref></para></listitem><listitem><para><ref refid="070__ref__variadic__template_8cpp_1a708a5bf22646ed7233fe61b83182811a" kindref="member">with template argument</ref></para></listitem></itemizedlist>
+See the <ref refid="class_test" kindref="compound">test</ref> class. </para>
+    </detaileddescription>
+    <location file="070_ref_variadic_template.cpp"/>
+  </compounddef>
+</doxygen>
diff --git a/testing/070_ref_variadic_template.cpp b/testing/070_ref_variadic_template.cpp
new file mode 100644
index 0000000..376cebe
--- /dev/null
+++ b/testing/070_ref_variadic_template.cpp
@@ -0,0 +1,95 @@
+// objective: test \ref command with a variadic template function
+// check: 070__ref__variadic__template_8cpp.xml
+
+/** \file
+ *
+ *  @attention
+ *  @parblock
+ *  At the time of writing, the part between \<\> is totally ignored:
+ *  %func<Args...>(Args... args) is interpreted as %func(Args... args).
+ *
+ *  Beware that a function parameter with either a \& or \* operator,
+ *  e.g. 'const Args&... args', requires \\link and \\ref to specify
+ *  such parameter as verbatim, i.e. 'const Args&... args'.  At the
+ *  time of writing, the form %func(const Args&...) will fail, unless
+ *  the function parameter was declared just as 'const Args&...'.
+ *  @endparblock
+ *
+ *  \ref Test::func(int,Args...)const "variadic template method"
+ *
+ *  References to the variadic template function overloads:
+ *    @li \ref func(int,Args&... args) "First overload"
+ *    @li \ref func(int,Args&&... args) "Second overload"
+ *    @li \ref func(int,const Args&... args) "Third overload"
+ *    @li \ref func(int,const Args&&... args) "Fourth overload"
+ *    @li \ref func(int,Args*... args) "Fifth overload"
+ *    @li \ref func(int,Args**... args) "Sixth overload"
+ *    @li \ref func(int,const Args*... args) "Seventh overload"
+ *    @li \ref func(int,const Args**... args) "Eighth overload"
+ *    @li \ref func(int,Args...) "Ninth overload"
+ *
+ *  The followings are interpreted the same:
+ *    @li \ref func(int,const Args&... args) "without template argument"
+ *    @li \ref func<Args...>(int,const Args&... args) "with template argument"
+ *
+ *  See the \ref Test "test" class.
+ */
+
+/** A function
+ */
+void func(int p);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args&&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args&&... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args*... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args**... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args*... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, const Args**... args);
+
+/** A variadic template function overload
+ */
+template <typename... Args>
+void func(int p, Args... args);
+
+/** A test */
+class Test
+{
+ public:
+  /** A variadic template method
+   */
+  template <typename... Args>
+  void func(int p, Args... args) const;
+};