Latex "warnings" (errors) when building the thorn guide

Create issue
Issue #885 closed
Erik Schnetter created an issue

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: Labelsec:eqn' multiply defined. LaTeX Warning: Label eq:eosformulas' multiply defined. LaTeX Warning: Labelsec:intro' multiply defined. LaTeX Warning: Label sec:intro' multiply defined. LaTeX Warning: Labelsec:eqn' multiply defined. LaTeX Warning: Label sec:use' multiply defined. LaTeX Warning: Labellivrevgrrfd' multiply defined. LaTeX Warning: Label livrevsrrfd' multiply defined. LaTeX Warning: CitationAHFinderDirect/York89' on page N47 undefined on input LaTeX Warning: Citation AHFinderDirect/Thornburg2003:AH-finding' on page N47 u LaTeX Warning: CitationAHFinderDirect/Thornburg95' on page N47 undefined on i LaTeX Warning: Citation AHFinderDirect/Schroeder86' on page N48 undefined on i LaTeX Warning: CitationAHFinderDirect/Schnetter03a' on page N61 undefined on LaTeX Warning: Citation AHFinderDirect/Thornburg95' on page N61 undefined on i LaTeX Warning: CitationAHFinderDirect/Dreyer-etal-2002-isolated-horizons' on LaTeX Warning: Citation AHFinderDirect/Schnetter03a' on page N65 undefined on LaTeX Warning: CitationAHFinderDirect/Schnetter03a' on page N65 undefined on LaTeX Warning: Citation AHFinderDirect/Schnetter03a' on page N65 undefined on LaTeX Warning: CitationAHFinderDirect/Thornburg95' on page N65 undefined on i LaTeX Warning: Citation AHFinderDirect/Thornburg2003:AH-finding' on page N65 u LaTeX Warning: CitationAHFinderDirect/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: CitationAHFinderDirect/Gundlach97a' on page N69 undefined on i LaTeX Warning: Citation AHFinderDirect/Schnetter02a' on page N69 undefined on LaTeX Warning: CitationAHFinderDirect/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.

Keyword:

Comments (8)

  1. Ian Hinder
    • removed comment

    I noticed a lot of commits relating to the documentation build. Are these all fixed now?

  2. Erik Schnetter reporter
    • removed comment

    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).

  3. Erik Schnetter reporter
    • changed status to open
    • removed 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.

  4. Frank Löffler
    • changed status to resolved
    • removed 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.

  5. Log in to comment