From 68f69414f7d358deac4876ede5be15e990da496b Mon Sep 17 00:00:00 2001
From: Jim Lersch <3578051-jlersch@users.noreply.gitlab.com>
Date: Thu, 26 Nov 2020 13:17:54 -0700
Subject: Workaround for doxygen class template titles in which the template
 part of the class signature is lost due to a problem with forward
 declarations.  The problem is probably caused by doxygen bug #7689. It is
 confirmed to be fixed in doxygen >= 1.8.19.

---
 doc/Doxyfile.in | 8 ++++++++
 1 file changed, 8 insertions(+)

(limited to 'doc')

diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in
index ddfd7e87f..bc1e03c40 100644
--- a/doc/Doxyfile.in
+++ b/doc/Doxyfile.in
@@ -737,6 +737,14 @@ EXCLUDE                = "${Eigen_SOURCE_DIR}/Eigen/src/Core/products" \
                          "${Eigen_SOURCE_DIR}/unsupported/doc/examples" \
                          "${Eigen_SOURCE_DIR}/unsupported/doc/snippets"
 
+# Forward declarations of class templates cause the title of the main page for
+# the class template to not contain the template signature.  This only happens
+# when the \class command is used to document the class.  Possibly caused
+# by https://github.com/doxygen/doxygen/issues/7698.  Confirmed fixed by
+# doxygen release 1.8.19.
+
+EXCLUDE += "${Eigen_SOURCE_DIR}/Eigen/src/Core/util/ForwardDeclarations.h"
+
 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
 # directories that are symbolic links (a Unix file system feature) are excluded
 # from the input.
-- 
cgit v1.2.3