The TeX FAQ

Frequently Asked Question List for TeX

Usage

(La)TeX makes overfull lines

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 “my words aren’t being hyphenated” (and the questions it references) for advice.

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 doesn’t 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.

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 try the LaTeX \linebreak 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.

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 \pretolerance, 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 \tolerance value. If this pass also fails, and the internal \emergencystretch value is positive, TeX will try a pass that allows \emergencystretch worth of extra stretchability to the spaces in each line.

In principle, therefore, there are three parameters (other than hyphenation) that you can change: \pretolerance, \tolerance and \emergencystretch. Both the tolerance values are simple numbers, and should be set by TeX primitive count assignment — for example

\pretolerance=150

For both, an “infinite” tolerance is represented by the value 10000, but infinite tolerance is rarely appropriate, since it can lead to very bad line breaks indeed.

\emergencystretch is a TeX-internal “dimen” register, and can be set as normal for dimens in Plain TeX; in LaTeX, use \setlength — for example:

\setlength{\emergencystretch}{3em}

The choice of method has time implications — each of the passes takes time, so adding a pass (by changing \emergencystretch) is less desirable than suppressing one (by changing \pretolerance). However, it’s unusual nowadays to find a computer that’s slow enough that the extra passes are really troublesome.

In practice, \pretolerance is rarely used other than to manipulate the use of hyphenation; Plain TeX and LaTeX both set its value to 100. To suppress the first scan of paragraphs, set \pretolerance to -1.

\tolerance is often a good method for adjusting spacing; Plain TeX and LaTeX both set its value to 200. LaTeX’s \sloppy command sets it to 9999, as does the sloppypar environment. This value is the largest available, this side of infinity, and can allow pretty poor-looking breaks (this author rarely uses \sloppy “bare”, though he does occasionally use sloppypar — that way, the change of \tolerance is confined to the environment). More satisfactory is to make small changes to \tolerance, incrementally, and then to look to see how the change affects the result; very small increases can often do what’s necessary. Remember that \tolerance is a paragraph parameter, so you need to ensure it’s actually applied — see “ignoring paragraph parameters”. LaTeX users could use an environment like:

\newenvironment{tolerant}[1]{%
  \par\tolerance=#1\relax
}{%
  \par
}

enclosing entire paragraphs (or set of paragraphs) in it.

The value of \emergencystretch is added to the assumed stretchability of each line of a paragraph, in a further run of the paragraph formatter in case that the paragraph can’t be made to look right any other way. (The extra scan happens if \emergencystretch>0pt — if it’s zero or negative, no gain could be had from rerunning the paragraph setter.) The example above set it to 3em; 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. It is therefore clear that \emergencystretch needs to be treated with a degree of caution.

More subtle (but more tricky to manage) are the microtypographic extensions provided by pdfTeX. Since pdfTeX is the default “engine” for LaTeX and ConTeXt work in all distributions, nowadays, the extensions are available to all. There are two extensions, margin kerning and font expansion; margin kerning only affects the visual effect of the typeset page, and has little effect on the ability of the paragraph setter to “get things right”. Font expansion works like a subtler version of the trick that \emergencystretch plays: pdfTeX “knows” that your current font may be stretched (or shrunk) to a certain extent, and will do that “on the fly” to optimise the setting of a paragraph. This is a powerful tool in the armoury of the typesetter.

As mentioned above, the microtypographic extensions are tricky beasts to control; however, the microtype package relieves the user of the tedious work of specifying how to perform margin adjustments and how much to scale each font … for the fonts the package knows about; it’s a good tool, and users who can take on the specification of adjustments for yet more fonts are always welcome.

FAQ ID: Q-overfull