summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-overfull.html
blob: af1cc71416dceb41900d8317c1cdadd194b9683d (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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
<head>
<title>UK TeX FAQ -- question label overfull</title>
</head><body>
<h3>(La)TeX makes overfull lines</h3>
<p>When TeX is building a paragraph, it can make several attempts to
get the line-breaking right; on each attempt it runs the same
algorithm, but gives it different parameters.  You can affect the way
TeX's line breaking works by adjusting the parameters: this answer
deals with the "tolerance" and stretchability parameters.  The other
vital 'parameter' is the set of hyphenations to be applied: see
"<a href="FAQ-nohyph.html">my words aren't being hyphenated</a>"
(and the questions it references) for advice.
<p>If you're getting an undesired "overfull box", what has happened is
that TeX has given up: the parameters you gave it don't allow it to
produce a result that <em>doesn't</em> overfill.  In this circumstance,
Knuth decided the best thing to do was to produce a warning, and to
allow the user to solve the problem.  (The alternative, silently to go
beyond the envelope of "good taste" defined for this run of TeX,
would be distasteful to any discerning typographer.)  The user can
almost always address the problem by rewriting the text that's
provoking the problem - but that's not always possible, and in some
cases it's impossible to solve the problem without adjusting the
parameters.  This answer discusses the approaches one might take to
resolution of the problem, on the assumption that you've got the
hyphenation correct.
<p>The simplest case is where a 'small' word fails to break at the end of
a line; pushing the entire word to a new line isn't going to make much
difference, but it might make things just bad enough that TeX won't
do it by default.  In such a case on can <em>try</em> the LaTeX
<code>\</code><code>linebreak</code> command: it may solve the problem, and if it does, it
will save an awful lot of fiddling.  Otherwise, one needs to adjust
parameters: to do that we need to recap the details of TeX's line
breaking mechanisms.
<p>TeX's first attempt at breaking lines is performed without even
trying hyphenation: TeX sets its "tolerance" of line breaking
oddities to the internal value <code>\</code><code>pretolerance</code>, and sees what
happens.  If it can't get an acceptable break, TeX adds the
hyphenation points allowed by the current patterns, and tries again
using the internal <code>\</code><code>tolerance</code> value.  If this pass also fails, and
the internal <code>\</code><code>emergencystretch</code> value is positive, TeX will try
a pass that allows <code>\</code><code>emergencystretch</code> worth of extra stretchability
to the spaces in each line.
<p>In principle, therefore, there are three parameters (other than
hyphenation) that you can change: <code>\</code><code>pretolerance</code>, <code>\</code><code>tolerance</code>
and <code>\</code><code>emergencystretch</code>.  Both the <code>tolerance</code> values are
simple numbers, and should be set by TeX primitive count
assignment - for example
<blockquote>
<pre>
\pretolerance=150
</pre>
</blockquote>
For both, an "infinite" tolerance is represented by the value
<code>10</code><code>000</code>, but infinite tolerance is rarely
appropriate, since it can lead to very bad line breaks indeed.
<p><code>\</code><code>emergencystretch</code> is a TeX-internal 'dimen' register, and can
be set as normal for dimens in Plain TeX; in LaTeX, use
<code>\</code><code>setlength</code> - for example:
<blockquote>
<pre>
\setlength{\emergencystretch}{3em}
</pre>
</blockquote>
<p>The choice of method has time implications - each of the
passes takes time, so adding a pass (by changing
<code>\</code><code>emergencystretch</code>) is less desirable than suppressing one (by
changing <code>\</code><code>pretolerance</code>).  However, it's unusual nowadays to find a
computer that's slow enough that the extra passes are really
troublesome.
<p>In practice, <code>\</code><code>pretolerance</code> is rarely used other than to manipulate
the use of hyphenation; Plain TeX and LaTeX both set its value
to <code>100</code>.  To suppress the first scan of paragraphs, set
<code>\</code><code>pretolerance</code> to <code>-1</code>.
<p><code>\</code><code>tolerance</code> is often a good method for adjusting spacing;
Plain TeX and LaTeX both set its value to <code>200</code>.  LaTeX's
<code>\</code><code>sloppy</code> command sets it to <code>9999</code>, as does the
<code>sloppypar</code> environment.  This value is the largest
available, this side of infinity, and can allow pretty poor-looking
breaks (this author rarely uses <code>\</code><code>sloppy</code> "bare", though he does
occasionally use <code>sloppypar</code> - that way, the change of
<code>\</code><code>tolerance</code> is confined to the environment).  More satisfactory is
to make small changes to <code>\</code><code>tolerance</code>, incrementally, and then to look to
see how the change affects the result; very small increases can often
do what's necessary.  Remember that <code>\</code><code>tolerance</code> is a paragraph
parameter, so you need to ensure it's actually applied - see
"<a href="FAQ-paraparam.html">ignoring paragraph parameters</a>".
LaTeX users could use an environment like:
<blockquote>
<pre>
\newenvironment{tolerant}[1]{%
  \par\tolerance=#1\relax
}{%
  \par
}
</pre>
</blockquote>
enclosing entire paragraphs (or set of paragraphs) in it.
<p><code>\</code><code>emergencystretch</code> is a slightly trickier customer to understand.
The example above set it to <code>3em</code>; the Computer Modern fonts
ordinarily fit three space skips to the em, so the change would
allow anything up to the equivalent of nine extra spaces in each
line.  In a line with lots of spaces, this could be reasonable, but
with (say) only three spaces on the line, each could stretch to four
times its natural width.
<p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=overfull">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=overfull</a>
</body>