28.03.2013 Views

Guide to LaTeX (4th Edition) (Tools and Techniques

Guide to LaTeX (4th Edition) (Tools and Techniques

Guide to LaTeX (4th Edition) (Tools and Techniques

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

C.6. Search for subtle errors 435<br />

badness 5504 is T E X’s estimate of how unacceptable the spacing is: the smaller<br />

this number the better.<br />

Underfull \vbox ....<br />

The page has been broken with head <strong>and</strong> foot justified, but T E X judges<br />

the amount of inter-paragraph spacing <strong>to</strong> be possibly unacceptable. The<br />

badness number here corresponds <strong>to</strong> the quantity with the same name<br />

from the Underfull \hbox warning.<br />

C.6 Search for subtle errors<br />

At some point or another you will encounter an error message for which<br />

you cannot identify any cause, try as you may. For such devious errors,<br />

we recommend the following search strategy:<br />

1. Copy the file twice in<strong>to</strong> a previous <strong>and</strong> a working copy (in addition<br />

<strong>to</strong> the original, which remains un<strong>to</strong>uched during this search).<br />

2. In the working copy, find the outermost environment where the error<br />

occurred <strong>and</strong> remove one or more inner environments. If there are<br />

no inner environments, shorten the remaining text. Process the file<br />

with L AT E X once more.<br />

3. If the error still occurs, copy the shortened working copy <strong>to</strong> the<br />

previous copy <strong>and</strong> repeat step 2. If the outer environment in step<br />

2 is \begin{document} ... \end{document}, the shortening may<br />

be carried out by simply inserting \end{document} at some earlier<br />

point.<br />

4. If the error is no longer in the shortened working copy, copy the<br />

previous copy back <strong>to</strong> the working copy. The error is still present in<br />

this version. Remove less of the text than last time <strong>and</strong> repeat steps<br />

2 <strong>to</strong> 4.<br />

5. If the error is found <strong>to</strong> be in the next innermost environment, repeat<br />

the procedure for this environment with steps 2 <strong>to</strong> 4.<br />

With this strategy, the error may be localized <strong>to</strong> one comm<strong>and</strong> or <strong>to</strong> the<br />

innermost environment with only a small remaining structure. If the<br />

error still cannot be identified in spite of its being precisely localized,<br />

seek help from a more experienced colleague or from the computing<br />

center. However, it is normally possible <strong>to</strong> recognize the mistake once the<br />

position of the error has been found.<br />

It does happen that even though the error has been corrected, the same<br />

error message appears on the next L AT E X process run. This is because of<br />

the internal transfer in information through the L AT E X auxiliary files, which

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!