#885: Latex "warnings" (errors) when building the thorn guide -----------------------------------+---------------------------------------- Reporter: eschnett | Owner: Type: defect | Status: new Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Keywords: | -----------------------------------+---------------------------------------- When building the thorn guide for the Einstein Toolkit thorn list, I receive the following "warnings" (which are really errors):
LaTeX Warning: Label `sec:utils' multiply defined. LaTeX Warning: Label `sec:eqn' multiply defined. LaTeX Warning: Label `eq:eosformulas' multiply defined. LaTeX Warning: Label `sec:intro' multiply defined. LaTeX Warning: Label `sec:intro' multiply defined. LaTeX Warning: Label `sec:eqn' multiply defined. LaTeX Warning: Label `sec:use' multiply defined. LaTeX Warning: Label `livrevgrrfd' multiply defined. LaTeX Warning: Label `livrevsrrfd' multiply defined. LaTeX Warning: Citation `AHFinderDirect/York89' on page N47 undefined on input LaTeX Warning: Citation `AHFinderDirect/Thornburg2003:AH-finding' on page N47 u LaTeX Warning: Citation `AHFinderDirect/Thornburg95' on page N47 undefined on i LaTeX Warning: Citation `AHFinderDirect/Schroeder86' on page N48 undefined on i LaTeX Warning: Citation `AHFinderDirect/Schnetter03a' on page N61 undefined on LaTeX Warning: Citation `AHFinderDirect/Thornburg95' on page N61 undefined on i LaTeX Warning: Citation `AHFinderDirect/Dreyer-etal-2002-isolated- horizons' on LaTeX Warning: Citation `AHFinderDirect/Schnetter03a' on page N65 undefined on LaTeX Warning: Citation `AHFinderDirect/Schnetter03a' on page N65 undefined on LaTeX Warning: Citation `AHFinderDirect/Schnetter03a' on page N65 undefined on LaTeX Warning: Citation `AHFinderDirect/Thornburg95' on page N65 undefined on i LaTeX Warning: Citation `AHFinderDirect/Thornburg2003:AH-finding' on page N65 u LaTeX Warning: Citation `AHFinderDirect/Thornburg95' on page N66 undefined on i LaTeX Warning: Float too large for page by 2.10869pt on input line 19559. LaTeX Warning: Citation `AHFinderDirect/Diener03a' on page N68 undefined on inp LaTeX Warning: Citation `AHFinderDirect/Gundlach97a' on page N69 undefined on i LaTeX Warning: Citation `AHFinderDirect/Schnetter02a' on page N69 undefined on LaTeX Warning: Citation `AHFinderDirect/Schnetter03a' on page N69 undefined on LaTeX Warning: Float too large for page by 6.24489pt on input line 25900. LaTeX Warning: There were undefined references. LaTeX Warning: There were multiply-defined labels.
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: Type: defect | Status: new Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: | Keywords: ------------------------------------+---------------------------------------
Comment (by hinder):
I noticed a lot of commits relating to the documentation build. Are these all fixed now?
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: Type: defect | Status: new Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: | Keywords: ------------------------------------+---------------------------------------
Comment (by eschnett):
All but one are corrected.
This last warning occurs while building the reference manual. This includes an appendix (verbatim) from the users' guide. This appendix refers to the main users' guide (via \ref{...}), and this reference cannot be resolved while building the reference manual: {{{ LaTeX Warning: Reference `sect-ThornWriting/DataTypes' on page C22 undefined on }}}
I don't see much value in including this appendix twice; I would just remove it from the reference manual (or from the users' guide).
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: Type: defect | Status: new Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: | Keywords: ------------------------------------+---------------------------------------
Comment (by hinder):
I agree.
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: knarf Type: defect | Status: accepted Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: | Keywords: ------------------------------------+--------------------------------------- Changes (by knarf):
* owner: => knarf * status: new => accepted
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: knarf Type: defect | Status: closed Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: fixed | Keywords: ------------------------------------+--------------------------------------- Changes (by knarf):
* status: accepted => closed * resolution: => fixed
Comment:
Nothing inside the appendix now references something outside.
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: knarf Type: defect | Status: reopened Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: | Keywords: ------------------------------------+--------------------------------------- Changes (by eschnett):
* status: closed => reopened * resolution: fixed =>
Comment:
I would rather have a reference that fails in the reference manual (and works fine in the users' guide) than removing information from the user's guide. Currently, the text uses the expression "the usual Cactus types" without explaining any more what they are. Another possible solution for this would have been to write "see section X.Y.Z in the User's Guide".
Also, Ian and I agreed above that it does not really make sense to have the same appendix appear in multiple documents. With the ticket closed, this will likely be forgotten.
If we want to clean up things for the release only, then we should branch.
#885: Latex "warnings" (errors) when building the thorn guide ------------------------------------+--------------------------------------- Reporter: eschnett | Owner: knarf Type: defect | Status: closed Priority: major | Milestone: ET_2012_05 Component: EinsteinToolkit thorn | Version: Resolution: fixed | Keywords: ------------------------------------+--------------------------------------- Changes (by knarf):
* status: reopened => closed * resolution: => fixed
Comment:
There are a lot (!) of references like this in the appendices, all commented out. I agree that another solution would be nicer however. So, let us close this ticket (which is now really solved, and I'll open another about all the commented out references or the removal of the appendix from one of the documents.
trac@lists.einsteintoolkit.org