I'm trying to generate LateX based code documentation using doxygen and using the make.bat created by doxygen to generate from LateX (refman.tex) a PDF.
Installations: Operating System: Windows Software:
- Doxygen 1.9.7
- MiKTeX 23.4
- Graphviz 8.0.5
Powershell script:
doxygen $configurationFile
$latextOutputDirectory = [System.IO.Path]::Combine($exportDirectory, "latex")
cd $latextOutputDirectory
Invoke-Expression -Command ".\make.bat"
make.bat generated by doxygen:
pushd %~dp0
if not %errorlevel% == 0 goto :end
set ORG_LATEX_CMD=%LATEX_CMD%
set ORG_MKIDX_CMD=%MKIDX_CMD%
set ORG_BIBTEX_CMD=%BIBTEX_CMD%
set ORG_LATEX_COUNT=%LATEX_COUNT%
set ORG_MANUAL_FILE=%MANUAL_FILE%
if "X"%LATEX_CMD% == "X" set LATEX_CMD=pdflatex
if "X"%MKIDX_CMD% == "X" set MKIDX_CMD=makeindex
if "X"%BIBTEX_CMD% == "X" set BIBTEX_CMD=bibtex
if "X"%LATEX_COUNT% == "X" set LATEX_COUNT=8
if "X"%MANUAL_FILE% == "X" set MANUAL_FILE=refman
del /s /f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl %MANUAL_FILE%.pdf
%LATEX_CMD% %MANUAL_FILE%
echo ----
%MKIDX_CMD% %MANUAL_FILE%.idx
echo ----
%LATEX_CMD% %MANUAL_FILE%
setlocal enabledelayedexpansion
set count=%LATEX_COUNT%
:repeat
set content=X
for /F "tokens=*" %%T in ( 'findstr /C:"Rerun LaTeX" %MANUAL_FILE%.log' ) do set content="%%~T"
if !content! == X for /F "tokens=*" %%T in ( 'findstr /C:"Rerun to get cross-references right" %MANUAL_FILE%.log' ) do set content="%%~T"
if !content! == X for /F "tokens=*" %%T in ( 'findstr /C:"Rerun to get bibliographical references right" %MANUAL_FILE%.log' ) do set content="%%~T"
if !content! == X goto :skip
set /a count-=1
if !count! EQU 0 goto :skip
echo ----
%LATEX_CMD% %MANUAL_FILE%
goto :repeat
:skip
endlocal
%MKIDX_CMD% %MANUAL_FILE%.idx
%LATEX_CMD% %MANUAL_FILE%
@REM reset environment
popd
set LATEX_CMD=%ORG_LATEX_CMD%
set ORG_LATEX_CMD=
set MKIDX_CMD=%ORG_MKIDX_CMD%
set ORG_MKIDX_CMD=
set BIBTEX_CMD=%ORG_BIBTEX_CMD%
set ORG_BIBTEX_CMD=
set MANUAL_FILE=%ORG_MANUAL_FILE%
set ORG_MANUAL_FILE=
set LATEX_COUNT=%ORG_LATEX_COUNT%
set ORG_LATEX_COUNT=
:end
Powershell output:
C:\src\project\docs\export\code\latex1>pushd C:\src\project\docs\export\code\latex1\
C:\src\project\docs\export\code\latex1>if not 0 == 0 goto :end
C:\src\project\docs\export\code\latex1>set ORG_LATEX_CMD=
C:\src\project\docs\export\code\latex1>set ORG_MKIDX_CMD=
C:\src\project\docs\export\code\latex1>set ORG_BIBTEX_CMD=
C:\src\project\docs\export\code\latex1>set ORG_LATEX_COUNT=
C:\src\project\docs\export\code\latex1>set ORG_MANUAL_FILE=
C:\src\project\docs\export\code\latex1>if "X" == "X" set LATEX_CMD=pdflatex
C:\src\project\docs\export\code\latex1>if "X" == "X" set MKIDX_CMD=makeindex
C:\src\project\docs\export\code\latex1>if "X" == "X" set BIBTEX_CMD=bibtex
C:\src\project\docs\export\code\latex1>if "X" == "X" set LATEX_COUNT=8
C:\src\project\docs\export\code\latex1>if "X" == "X" set MANUAL_FILE=refman
C:\src\project\docs\export\code\latex1>del /s /f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log
*.out *.brf *.blg *.bbl refman.pdf
Deleted file - C:\src\project\docs\export\code\latex1\refman.aux
Deleted file - C:\src\project\docs\export\code\latex1\refman.toc
Deleted file - C:\src\project\docs\export\code\latex1\refman.idx
Deleted file - C:\src\project\docs\export\code\latex1\refman.log
Deleted file - C:\src\project\docs\export\code\latex1\refman.out
C:\src\project\docs\export\code\latex1>pdflatex refman
This is pdfTeX, Version 3.141592653-2.6-1.40.25 (MiKTeX 23.5) (preloaded format=pdflatex.fmt)
restricted \write18 enabled.
entering extended mode
(refman.tex
LaTeX2e <2023-06-01> patch level 1
L3 programming layer <2023-06-30>
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\article.cls
Document Class: article 2023/05/17 v1.4n Standard LaTeX document class
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\size10.clo))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\ifthen.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tools\array.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tools\array-2016-10-06.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/infwarerr\infwarerr.sty) (doxygen.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\alltt.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tools\calc.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/float\float.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tools\verbatim.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/xcolor\xcolor.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics-cfg\color.cfg)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics-def\pdftex.def)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/colortbl\colortbl.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics\mathcolor.ltx)) (longtable_doxygen.sty)(tabu_doxygen.sty(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/varwidth\varwidth.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/fancyvrb\fancyvrb.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics\keyval.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tools\tabularx.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tools\multicol.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/multirow\multirow.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hanging\hanging.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/iftex\ifpdf.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/iftex\iftex.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/adjustbox\adjustbox.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/xkeyval\xkeyval.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/xkeyval\xkeyval.tex
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/xkeyval\xkvutils.tex)))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/adjustbox\adjcalc.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/adjustbox\trimclip.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics\graphicx.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics\graphics.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics\trig.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/graphics-cfg\graphics.cfg)))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/collectbox\collectbox.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/adjustbox\tc-pdftex.def))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/ifoddpage\ifoddpage.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/amsfonts\amssymb.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/amsfonts\amsfonts.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/stackengine\stackengine.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/etoolbox\etoolbox.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/listofitems\listofitems.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/listofitems\listofitems.tex)))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/enumitem\enumitem.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/alphalph\alphalph.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/intcalc\intcalc.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/ulem\ulem.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\inputenc.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\makeidx.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\textcomp.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/wasysym\wasysym.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/iftex\ifxetex.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\fontenc.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/psnfss\helvet.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/psnfss\courier.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/geometry\geometry.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/iftex\ifvtex.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/geometry\geometry.cfg))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/changepage\changepage.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/fancyhdr\fancyhdr.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/natbib\natbib.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/tocloft\tocloft.sty)
Writing index file refman.idx
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/newunicodechar\newunicodechar.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hyperref\hyperref.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/ltxcmds\ltxcmds.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/pdftexcmds\pdftexcmds.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/kvsetkeys\kvsetkeys.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/kvdefinekeys\kvdefinekeys.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/pdfescape\pdfescape.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hycolor\hycolor.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/letltxmacro\letltxmacro.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/auxhook\auxhook.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hyperref\nameref.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/refcount\refcount.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/gettitlestring\gettitlestring.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/kvoptions\kvoptions.sty)))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hyperref\pd1enc.def)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hyperref\puenc.def)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hyperref\backref.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/rerunfilecheck\rerunfilecheck.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\atveryend-ltx.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/uniquecounter\uniquecounter.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/bigintcalc\bigintcalc.sty))))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/url\url.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/generic/bitset\bitset.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/base\atbegshi-ltx.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/hyperref\hpdftex.def)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/caption\caption.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/caption\caption3.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/caption\ltcaption.sty))
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/etoc\etoc.sty)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/psnfss\t1phv.fd)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/l3backend\l3backend-pdftex.def)
No file refman.aux.
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/context/base/mkii\supp-pdf.mkii
[Loading MPS to PDF converter (version 2006.09.02).]
)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/epstopdf-pkg\epstopdf-base.sty
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/00miktex\epstopdf-sys.cfg))
*geometry* driver: auto-detecting
*geometry* detected driver: pdftex
No file refman.toc.
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/amsfonts\umsa.fd)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/amsfonts\umsb.fd)
(C:\Users\user\AppData\Local\Programs\MiKTeX\tex/latex/wasysym\uwasy.fd)
[1{C:/Users/user/AppData/Local/MiKTeX/fonts/map/pdftex/pdftex.map}{C:/Use
rs/user/AppData/Local/Programs/MiKTeX/fonts/enc/dvips/base/8r.enc}]
(namespaces.tex
LaTeX Warning: Reference `namespace_x' on page 1 undefined on input line 3.
LaTeX Warning: Reference `namespace_x_1_1_y' on page 1 undefined on input line 4.
LaTeX Warning: Reference `namespace_x_1_1_y_1_1_l_d_a' on page 1 undefined on input line 5.
Errors:
- No file refman.aux
- No file refman.toc
- LaTeX Warning: Reference `namespace_x' on page 1 undefined on input line 3.
In my opinion the code cannot be the issue, since generating the HTML based code documentation works fine. But using latex & the make.bat is not working and it doesn't make a difference using Powershell or the cmd, the error outcome is the same.
The doxygen configuration looks as follows:
Generating the latex ends with