doxygen icon indicating copy to clipboard operation
doxygen copied to clipboard

Tables in latex has empty caption that results in useless list of tables

Open sbellus opened this issue 2 months ago • 7 comments

Describe the bug List of tables has no names

Screenshots Before 1.15.0 (not named tables are not in table list)

Image

1.15.0

Image

To Reproduce Create some table in documentation and in latex header use command \listoftables.

Expected behavior My suggestion is to make it backward compatible and do not generate latex table with empty heading

Version 1.15.0

sbellus avatar Oct 28 '25 11:10 sbellus

Without an example it is hard to reproduce, so

  • 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).

albert-github avatar Oct 28 '25 11:10 albert-github

Yes I can, probably end of this week

sbellus avatar Oct 28 '25 12:10 sbellus

It happens due to \SetTblrOuter[longtblr]{theme=DoxyTableBareTheme}% To remove it from \listoftables use \SetTblrOuter[longtblr]{theme=DoxyTableBareTheme, entry=none}%

sbellus avatar Oct 28 '25 13:10 sbellus

Thanks for the hint. I seen the documentation:

If you write entry=none, tabularray package will not add an entry in List of Tables. Therefore caption=text,entry=none is similar to \caption[]{text} in longtable. If you write label=none, tabularray package will not step table counter, and set the caption-tag and caption-sep elements (see below) to empty. Therefore caption=text,entry=none,label=none is similar to \caption*{text} in longtable, except for the counter.

  • my question is what will happen when there is a mixture of tables with and without a caption present?
  • furthermore it doxygen does not (yet) support the behavior to add the \listoftables so anything can happen.

albert-github avatar Oct 28 '25 13:10 albert-github

I did a small test and it looks like the ,entry=none should be added to line 409 (i.e. the first setTblrOuter of \NewDocumentEnvironment{DoxyTable}) and to line 464 (i.e. setTblrOuter of \NewDocumentCommand{\DoxyParamTable}).

(I did a quick test with the doxygen manual).

albert-github avatar Oct 28 '25 14:10 albert-github

I've just pushed a proposed patch, pull request #11840

albert-github avatar Oct 29 '25 09:10 albert-github

Code has been integrated in master on GitHub (please don't close the issue as this will be done at the moment of an official release).

albert-github avatar Oct 30 '25 09:10 albert-github