Menu

latex generation seems broken with doxygen 1.8.15

g
2019-01-21
2019-06-29
  • g

    g - 2019-01-21

    Hi everybody,

    I am trying to generate .tex files to be compiled in order to get a pdf version of my documentation. However, I get a lot of Missing } inserted. \end{DoxyEnumFields} and Missing \cr inserted. \end{DoxyEnumFields} errors when compiling with pdflatex (I use TexLive 2018). The related doxygen configuration I use is

    #---------------------------------------------------------------------------
    # Configuration options related to the LaTeX output
    #---------------------------------------------------------------------------
    
    # If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
    # The default value is: YES.
    
    GENERATE_LATEX         = YES
    
    # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
    # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
    # it.
    # The default directory is: latex.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_OUTPUT           = latex
    
    # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
    # invoked.
    #
    # Note that when enabling USE_PDFLATEX this option is only used for generating
    # bitmaps for formulas in the HTML output, but not in the Makefile that is
    # written to the output directory.
    # The default file is: latex.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_CMD_NAME         = latex
    
    # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
    # index for LaTeX.
    # The default file is: makeindex.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    MAKEINDEX_CMD_NAME     = makeindex
    
    # If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX
    # documents. This may be useful for small projects and may help to save some
    # trees in general.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    COMPACT_LATEX          = YES
    
    # The PAPER_TYPE tag can be used to set the paper type that is used by the
    # printer.
    # Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
    # 14 inches) and executive (7.25 x 10.5 inches).
    # The default value is: a4.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    PAPER_TYPE             = a4
    
    # The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
    # that should be included in the LaTeX output. The package can be specified just
    # by its name or with the correct syntax as to be used with the LaTeX
    # \usepackage command. To get the times font for instance you can specify :
    # EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}
    # To use the option intlimits with the amsmath package you can specify:
    # EXTRA_PACKAGES=[intlimits]{amsmath}
    # If left blank no extra packages will be included.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    EXTRA_PACKAGES         = draftwatermark
    
    # The LATEX_HEADER tag can be used to specify a personal LaTeX header for the
    # generated LaTeX document. The header should contain everything until the first
    # chapter. If it is left blank doxygen will generate a standard header. See
    # section "Doxygen usage" for information on how to let doxygen write the
    # default header to a separate file.
    #
    # Note: Only use a user-defined header if you know what you are doing! The
    # following commands have a special meaning inside the header: $title,
    # $datetime, $date, $doxygenversion, $projectname, $projectnumber,
    # $projectbrief, $projectlogo. Doxygen will replace $title with the empty
    # string, for the replacement values of the other commands the user is referred
    # to HTML_HEADER.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_HEADER           =
    
    # The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the
    # generated LaTeX document. The footer should contain everything after the last
    # chapter. If it is left blank doxygen will generate a standard footer. See
    # LATEX_HEADER for more information on how to generate a default footer and what
    # special commands can be used inside the footer.
    #
    # Note: Only use a user-defined footer if you know what you are doing!
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_FOOTER           =
    
    # The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined
    # LaTeX style sheets that are included after the standard style sheets created
    # by doxygen. Using this option one can overrule certain style aspects. Doxygen
    # will copy the style sheet files to the output directory.
    # Note: The order of the extra style sheet files is of importance (e.g. the last
    # style sheet in the list overrules the setting of the previous ones in the
    # list).
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_EXTRA_STYLESHEET =
    
    # The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
    # other source files which should be copied to the LATEX_OUTPUT output
    # directory. Note that the files will be copied as-is; there are no commands or
    # markers available.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_EXTRA_FILES      =
    
    # If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
    # prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
    # contain links (just like the HTML output) instead of page references. This
    # makes the output suitable for online browsing using a PDF viewer.
    # The default value is: YES.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    PDF_HYPERLINKS         = YES
    
    # If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
    # the PDF file directly from the LaTeX files. Set this option to YES, to get a
    # higher quality PDF documentation.
    # The default value is: YES.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    USE_PDFLATEX           = YES
    
    # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
    # command to the generated LaTeX files. This will instruct LaTeX to keep running
    # if errors occur, instead of asking the user for help. This option is also used
    # when generating formulas in HTML.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_BATCHMODE        = YES
    
    # If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
    # index chapters (such as File Index, Compound Index, etc.) in the output.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_HIDE_INDICES     = NO
    
    # If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source
    # code with syntax highlighting in the LaTeX output.
    #
    # Note that which sources are shown also depends on other settings such as
    # SOURCE_BROWSER.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_SOURCE_CODE      = YES
    
    # The LATEX_BIB_STYLE tag can be used to specify the style to use for the
    # bibliography, e.g. plainnat, or ieeetr. See
    # https://en.wikipedia.org/wiki/BibTeX and \cite for more info.
    # The default value is: plain.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_BIB_STYLE        = IEEEtran
    
    # If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
    # page will contain the date and time when the page was generated. Setting this
    # to NO can help when comparing the output of multiple runs.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_TIMESTAMP        = NO
    

    By digging a little bit it looks like the Latex engine fails to parse some strings, so this could be a latex issue and a little bit off topic here. My question is if anybody here got into the same issue. Long time ago (doxygen 1.8.11) I could get correct latex compialtion, however many things have changed since then, I guess.

    Thank you.

     
  • Peter Olsson

    Peter Olsson - 2019-04-07

    I just discovered the exact same problem. Does anyone know if there has been any progress on this issue?

     
  • Kai Scheddin

    Kai Scheddin - 2019-04-28

    I have the same issue with version 1.18.15

     
  • Irfaun Rahaman

    Irfaun Rahaman - 2019-06-11

    I have the same failure (version 1.18.15) and isolated it to a table in my document.
    I tried implementing the table in markdown and html, but the failure occurrs regardless of the implementation type or table complexity. The PDF was generated once the table was removed.

     
  • Bastiaan Veelo

    Bastiaan Veelo - 2019-06-29

    This is due to the dependency on the unmaintained tabu package: https://github.com/doxygen/doxygen/issues/6769, which stopped working since the LaTeX update from December 2018. Tabu made its introduction in Doxygen in 1.8.11. Sadly tabu's author gave up on it around that very same time.

     

Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.