summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rerun.html
blob: d5b99c3b70b2e5a1d47b191a7e4fe6b4ab522cb4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<head>
<title>UK TeX FAQ -- question label rerun</title>
</head><body>
<h3>&#8220;Rerun&#8221; messages won&#8217;t go away</h3>
<p/>The LaTeX message &#8220;Rerun to get crossreferences right&#8221; is
supposed to warn the user that the job needs to be processed again,
since labels seem to have changed since the previous run.  (LaTeX
compares the labels it has created this time round with what it found
from the previous run when it started; it does this comparison at
<code>\</code><code>end{document}</code>.)
<p/>Sometimes, the message won&#8217;t go away: however often you reprocess your
document, LaTeX still tells you that &#8220;Label(s) may have
changed&#8221;.  This can sometimes be caused by a broken package: both
<i>footmisc</i> (with the <code>perpage</code> option) and <i>hyperref</i>
have been known to give trouble, in the past: if you are using either,
check you have the latest version, and upgrade if possible.
<p/>However, there <em>is</em> a rare occasion when this error can happen
as a result of pathological structure of the document itself.  Suppose
you have pages numbered in roman, and you add a reference to a label
on page &#8220;ix&#8221; (9).  The presence of the reference pushes the thing
referred to onto page &#8220;x&#8221; (10), but since that&#8217;s a shorter reference
the label moves back to page &#8220;ix&#8221; at the next run.  Such a sequence
can obviously not terminate.
<p/>The only solution to this problem is to make a small change to your
document (something as small as adding or deleting a comma will often
be enough).
<dl>
<dt><tt><i>footmisc.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/footmisc.zip">macros/latex/contrib/footmisc</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/footmisc/">browse the directory</a>)
<dt><tt><i>hyperref.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/hyperref.zip">macros/latex/contrib/hyperref</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/hyperref/">browse the directory</a>)
</dl>
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=rerun">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=rerun</a>
</body>