New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

nested html tables cause pdflatex to hang (1.8.4 and 1.8.6) (Origin: bugzilla #732768) #5514

doxygen opened this Issue Jul 2, 2018 · 0 comments


None yet
1 participant

doxygen commented Jul 2, 2018

status RESOLVED severity major in component general for ---
Reported in version 1.8.6 on platform Other
Assigned to: Dimitri van Heesch

Original attachment names and IDs:

On 2014-07-05 14:10:40 +0000, Matthias Heil wrote:

Created attachment 279947
transcript of successful build with version 1.7.4

versions 1.8.4 and 1.8.6 of doxygen hang when pdflatex tries to process
the latex source generated from code whose documentation contains nested
html tables. version 1.7.4 works fine -- this may help to narrow things down.

[This is "major" for us because we (used to) use doxygen
to generate pdf-based documentation automatically and the entire build
process for our library now hangs when it generates the documentation.]

The most simplistic "code" that illustrates the problem is this:


\mainpage bla



I'm attaching transcripts of the respective attempts to build
the documentation (using 1.7.4 and 1.8.4; note that in both
cases I'm "more"-ing the generated latex code) as well as the source
code (already listed above) and a successfully built pdf file.

On 2014-07-05 14:13:19 +0000, Matthias Heil wrote:

Created attachment 279948
transcript of unsuccessful build with version 1.8.4

On 2014-07-05 14:14:02 +0000, Matthias Heil wrote:

Created attachment 279949
source code that creates the problem

On 2014-07-05 14:14:35 +0000, Matthias Heil wrote:

Created attachment 279950
successfully generated pdf file

On 2014-07-20 07:48:04 +0000, Dimitri van Heesch wrote:

The problem seems to come from the use of xtabular in doxygen.sty instead of tabular that was still used <1.8.0.

So a quick workaround is to use a custom stylesheet.

First run:

doxygen -w latex header.tex footer.tex mydoxygen.sty

edit mydoxygen.sty and replace xtabular by tabular.

Put the following in the config file
LATEX_HEADER = header.tex
LATEX_EXTRA_FILES = mydoxygen.sty

(the latter option requires a recent version of doxygen, for older versions you have to copy mydoxygen.sty to the latex output directory yourself).

On 2014-07-21 17:00:23 +0000, Matthias Heil wrote:

Brilliant -- this seems to fix it. Thanks for your quick response!

We'll use this as work-around. In fact, what's the advantage of
switching to xtabular in the first place? [No need to reply -- I'm sure
you've got better things to do!]

Thanks again,


On 2014-07-21 18:05:29 +0000, Dimitri van Heesch wrote:

advantage of xtabular: large tables will not run into the page margin and off of the page, but instead the table will be split over multiple pages automatically.

On 2014-08-08 09:44:59 +0000, Dimitri van Heesch wrote:

Since the issue seems to be with nesting xtabular's only, I'll make doxygen use xtabular for the outer tables, and tabular for any nested tables.

On 2014-08-21 17:15:40 +0000, Dimitri van Heesch wrote:

This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.8. Please verify if this is indeed the case. Reopen the
bug if you think it is not fixed and please include any additional information
that you think can be relevant (preferrably in the form of a self-contained example).

@doxygen doxygen closed this Jul 2, 2018

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment