doxygen-1.6.3 fails to build its docs

[daniel.hornung@…]

Building the docs for doxygen-1.6.3 fails here because the latex package "tocloft" cannot be found:

:info:build gmake[1]: Entering directory `/opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_release_ports_textproc_doxygen/work/doxygen-1.6.3/latex'
:info:build echo "Running latex..."
:info:build Running latex...
:info:build pdflatex doxygen_manual.tex
:info:build This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live/MacPorts 2009_3)
:info:build entering extended mode
:info:build (./doxygen_manual.tex
:info:build LaTeX2e <2009/09/24>
:info:build Babel <v3.8l> and hyphenation patterns for english, usenglishmax, dumylang, noh
:info:build yphenation, czech, slovak, dutch, basque, french, german-x-2009-06-19, ngerman-
:info:build x-2009-06-19, german, ngerman, italian, polish, portuguese, spanish, catalan, g
:info:build alician, ukenglish, loaded.
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/base/report.cls
:info:build Document Class: report 2007/10/19 v1.4h Standard LaTeX document class
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/base/size10.clo))
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/ltxmisc/a4wide.sty
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/ntgclass/a4.sty))
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/base/makeidx.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/fancyhdr/fancyhdr.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/float/float.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/graphics/graphicx.sty
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/graphics/keyval.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/graphics/graphics.sty
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/graphics/trig.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/latexconfig/graphics.cfg)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/pdftex-def/pdftex.def)))
:info:build (/opt/local/share/texmf-texlive-dist/tex/generic/epsf/epsf.sty
:info:build This is `epsf.tex' v2.7.3 <23 July 2005>
:info:build ) (./doxygen.sty (/opt/local/share/texmf-texlive-dist/tex/latex/tools/calc.sty)
:info:build  (/opt/local/share/texmf-texlive-dist/tex/latex/tools/array.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/tools/verbatim.sty))
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/tools/multicol.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/psnfss/times.sty)
:info:build (/opt/local/share/texmf-texlive-dist/tex/latex/base/alltt.sty)
:info:build
:info:build ! LaTeX Error: File `tocloft.sty' not found.
:info:build
:info:build Type X to quit or <RETURN> to proceed,
:info:build or enter new name. (Default extension: sty)
:info:build
:info:build Enter file name:
:info:build ! Emergency stop.
:info:build <read *>
:info:build
:info:build l.27 \usepackage
:info:build                 [pdftex,^^M
:info:build !  ==> Fatal error occurred, no output PDF file produced!
:info:build Transcript written on doxygen_manual.log.
:info:build gmake[1]: *** [doxygen_manual.pdf] Error 1

Disabling the "docs" variant seems to help as a workaround.

[daniel.hornung@…]

Actually the exact doxygen version is 1.6.3_2 here.

[ryandesign (Ryan Carsten Schmidt)]

Remember to fill in the Port field and Cc the port's maintainer.

[jmroot (Joshua Root)]

Needs a build dep on texlive-latex-extra.

[daniel.hornung@…]

Patch for doxygen

[daniel.hornung@…]

On a different note, doxygen also fails to build with more than one process, so maybe

use_parallel_build  no

should be used somewhere? More specifically, it looks to me as if the make pdf target tries to use the doxygen executable itself, which doesn't exist yet at this moment.

[cssdev]

Is it only the documentation that fails to build with more than one process? It appears that doxygen itself builds fine with a parallel build. I could add that to the docs variant and preserve the better build time for those not building the documentation.

[cssdev]

Fixed in r69976. Thanks for submitting the bug!

[takanori@…]

After the changes in r69976, 'doxygen +doc' fails to build with pTeX.

pTeX is a Japanese TeX distribution based on teTeX, and it contains tocloft.sty, so I tried to change the doxygen's dependency declaration like the following to allow building 'doxygen +doc' with not only TeXLive but also pTeX.

  from
    port:texlive-latex-extra
  to
    path:${prefix}/share/texmf-dist/tex/latex/tocloft/tocloft.sty:texlive-latex-extra

But it didn't work as expected, because the recent MacPorts' TeXLive installs its macro files into 'texmf-texlive-dist' directory, not 'texmf-dist' directory.

  pTeX:
  $ kpsewhich tocloft.sty
  /opt/local/share/texmf-dist/tex/latex/tocloft/tocloft.sty

  TeXLive:
  $ kpsewhich tocloft.sty
  /opt/local/share/texmf-texlive-dist/tex/latex/tocloft/tocloft.sty
                         ^^^^^^^^

Is there any smart way to solve this problem? Thanks in advance.

p.s.

Please not that this is not just a problem between TeXLive and pTeX. When port:MacTeX (or something) is released, the same problem will occur between TeXLive and MacTeX (or something).

In my current opinion, TeXLive should be reverted to use texmf-dist, not to use texmf-texlive-dist.

[cssdev]

This seems over my head in terms of managing the differences among various TeX distributions. Did doxygen documentation work with pTeX previously at some point? This might be better served in a separate ticket that can address the unique aspects of managing the differences between the TeX packages.

[daniel.hornung@…]

Replying to css@…:

Is it only the documentation that fails to build with more than one process? It appears that doxygen itself builds fine with a parallel build. I could add that to the docs variant and preserve the better build time for those not building the documentation.

So it seems to me, yes. Of course, you never know what timing issues play a role with parallel builds :)

Thanks for pushing the changes!

[cssdev]

Replying to takanori@…:

After the changes in r69976, 'doxygen +doc' fails to build with pTeX.

I created #26002 for handling the pTeX issues. The core problem from this ticket is resolved when using texlive.