Opened 14 years ago
Closed 14 years ago
#548 closed defect (fixed)
make doc gets stuck in latex prompt
Reported by: | Peter | Owned by: | Jari Häkkinen |
---|---|---|---|
Priority: | major | Milestone: | yat 0.5.4 |
Component: | documentation | Version: | 0.5.3 |
Keywords: | Cc: |
Description
make doc does not work for me. Well actually it is the latex part that wont work, but instead it gets stuck in a latex prompt:
... See the LaTeX manual or LaTeX Companion for explanation. Type H <return> for immediate help. ... l.262 \end{document} ?
This per se is not severe because I can build the html docs (that I care about) via make html
, but the annoying thing is that documentation_test.sh calls make doc
and thus also gets stuck and here we get stuck blindly since all output is redirected to /dev/null
.
limpar:~/projects/yat-0.5.x peter$ latex --version pdfTeX 3.141592-1.40.3-2.2 (Web2C 7.5.6) kpathsea version 3.5.6 Copyright 2007 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX). Kpathsea is copyright 2007 Karl Berry and Olaf Weber. There is NO warranty. Redistribution of this software is covered by the terms of both the pdfTeX copyright and the Lesser GNU General Public License. For more information about these matters, see the file named COPYING and the pdfTeX source. Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX). Kpathsea written by Karl Berry, Olaf Weber, and others. Compiled with libpng 1.2.35; using libpng 1.2.35 Compiled with zlib 1.2.3; using zlib 1.2.3 Compiled with xpdf version 3.01
Change History (17)
comment:1 Changed 14 years ago by
comment:2 Changed 14 years ago by
It works fine on GNU/Linux Fedora 8 using
> doxygen --version 1.5.6 > latex --version | head -n 2 pdfeTeX 3.141592-1.21a-2.2 (Web2C 7.5.4) kpathsea version 3.5.4
comment:3 Changed 14 years ago by
make check
does not complete on my Mac OS X 10.5.7
> doxygen --version 1.5.8 > latex --version pdfeTeX 3.141592-1.21a-2.2 (Web2C 7.5.4) kpathsea version 3.5.4
comment:4 follow-up: 5 Changed 14 years ago by
OK, so the common denominators for failure are Mac (I have 10.4) and doxygen 1.5.8. Likely this is a problem in doxygen 1.5.8 or in our syntax. We need to track down which of our files that is input here, to see if there is something wrong in our comments.
Is it possible to call latex in a portable way such that errors are ignored?
Note that make check in trunk is still fine because the docs test was changed to issue make doc in 0.5.4pre which is not yet merged in to trunk.
comment:5 follow-ups: 6 7 Changed 14 years ago by
Replying to peter:
OK, so the common denominators for failure are Mac (I have 10.4) and doxygen 1.5.8. Likely this is a problem in doxygen 1.5.8 or in our syntax. We need to track down which of our files that is input here, to see if there is something wrong in our comments.
I think the problem is in yat/utility/stl_utility.h but that is a fairly wild guess.
Note that make check in trunk is still fine because the docs test was changed to issue make doc in 0.5.4pre which is not yet merged in to trunk.
Well, make doc
fails in the trunk so the problem is also in trunk.
comment:6 follow-up: 8 Changed 14 years ago by
Replying to jari:
I think the problem is in yat/utility/stl_utility.h but that is a fairly wild guess.
Now I think it is yat/utility/SVD.h
comment:7 follow-up: 9 Changed 14 years ago by
comment:8 follow-up: 10 Changed 14 years ago by
comment:9 Changed 14 years ago by
Replying to peter:
I said
make check
is fine in trunk.
Of course, I just wanted to clarify that the problem also exist in the trunk, not as annoying as in 0.5 though.
comment:10 Changed 14 years ago by
Replying to peter:
Replying to jari:
Replying to jari:
I think the problem is in yat/utility/stl_utility.h but that is a fairly wild guess.
Now I think it is yat/utility/SVD.h
Yeah, I think you remembered before some problem with the
enum
.
Yes, the problem is
enum SVDalgorithm { GolubReinsch, ModifiedGolubReinsch, Jacobi };
comment:11 follow-up: 12 Changed 14 years ago by
And the problem is in doxygen. The new 1.5.9 relased May 23, 2009 claims to have fixed the issue:
id 567777: Fixed problem with latex output when using enums.
So, we have to wait for a newer doxygen in macports.
comment:12 Changed 14 years ago by
Replying to jari:
And the problem is in doxygen. The new 1.5.9 relased May 23, 2009 ...
1.5.9 was released April 30, the web page I am citing was updated May 23!
comment:13 follow-up: 16 Changed 14 years ago by
OK, I think we should increase the resolution of the configure test, enable htlm output when that is possible and enable other output when that is possible. Using doxygen 1.5.6 is fine so I think we should allow that, but ban 1.5.8 for latex generation.
Also I would like to turn off the prompt when experiencing latex errors (?)
comment:14 Changed 14 years ago by
comment:15 Changed 14 years ago by
comment:16 follow-up: 17 Changed 14 years ago by
Replying to peter:
Also I would like to turn off the prompt when experiencing latex errors (?)
There is an option LATEX_BATCHMODE in doxygen configure file that seems to turn off the prompt. Is that something we want to use?
comment:17 Changed 14 years ago by
Resolution: | → fixed |
---|---|
Status: | new → closed |
Replying to peter:
Replying to peter:
Also I would like to turn off the prompt when experiencing latex errors (?)
There is an option LATEX_BATCHMODE in doxygen configure file that seems to turn off the prompt. Is that something we want to use?
I tried batch mode a bit, and I dont like it. The batch is also turned on when created images of equations for the html output. When there is a syntax error, it can easily pass by instead of, as now, stopping with a clear error message.
Clarification:
cd doc && make latex-local
works but it iscd doc && make dvi-local
that is problematic, i.e., converting doxygen generated latex source into a dvi file.