Merge pull request #11688 from albert-github/feature/bug_tblr_empty_label

doxygen · web-flow · commit 445ff9a3a11c · 2025-08-02T21:30:23.000+01:00
Don't label an empty label as `_` with a table
diff --git a/src/latexdocvisitor.cpp b/src/latexdocvisitor.cpp
@@ -1307,7 +1307,7 @@ void LatexDocVisitor::operator()(const DocHtmlTable &t)
     m_t << "}";
     // write label
     m_t << "{";
-    if (c)
+    if (c && (!stripPath(c->file()).isEmpty() || !c->anchor().isEmpty()))
     {
       m_t << stripPath(c->file()) << "_" << c->anchor();
     }
diff --git a/templates/latex/doxygen.sty b/templates/latex/doxygen.sty
@@ -373,10 +373,15 @@
 \NewDocumentEnvironment{DoxyTable}{m +m m m +b}{%
 \par%
 \def\hascaption{#2}%
+\def\haslabel{#3}%
 \ifx\hascaption\empty% if caption is empty
   \SetTblrOuter[longtblr]{theme=DoxyTableBareTheme}% table without caption or label
 \else% caption not empty
-  \SetTblrOuter[longtblr]{theme=DoxyTableCaptionTheme,caption={#2},label={#3}}% set table caption and label
+  \ifx\haslabel\empty% if label is empty
+    \SetTblrOuter[longtblr]{theme=DoxyTableCaptionTheme,caption={#2}}% set table caption
+  \else% label not empty
+    \SetTblrOuter[longtblr]{theme=DoxyTableCaptionTheme,caption={#2},label={#3}}% set table caption and label
+  \fi%
 \fi%
 \sbox0{% first render the table in a savebox to calculate the width of the table which will be stored in \wd0
 \begin{tblr}{hlines,vlines,measure=vbox,colspec={*{#1}{l}}}%
@@ -424,7 +429,7 @@
 % Arguments:
 % #1: Number of columns
 % #2: Initial format for tblr, i.e. format except for last column
-% #3: Title of the table ee.g. Params, Enumerator
+% #3: Title of the table e.g. Params, Enumerator
 % #4: Body
 \NewDocumentCommand{\DoxyParamTable}{m m +m +m}{%
   \SetTblrOuter[longtblr]{theme=DoxyTableBareTheme}% set table caption and label

Original file line number	Diff line number	Diff line change
`@@ -1307,7 +1307,7 @@ void LatexDocVisitor::operator()(const DocHtmlTable &t)`
`1307`	`1307`	`m_t << "}";`
`1308`	`1308`	`// write label`
`1309`	`1309`	`m_t << "{";`
`1310`		`- if (c)`
	`1310`	`+ if (c && (!stripPath(c->file()).isEmpty() \|\| !c->anchor().isEmpty()))`
`1311`	`1311`	`{`
`1312`	`1312`	`m_t << stripPath(c->file()) << "_" << c->anchor();`
`1313`	`1313`	`}`