Аварійна зупинка й runaway argument

Фатальні переривання через пропущені end, дужки або хибні підключення файлів.

Аварійна зупинка й runaway argument

Симптом

Компіляція просто обривається. Журнал закінчується рядком ! Emergency stop. або показує Runaway argument?, після якого йде довгий шматок вашого власного тексту, часто із супровідним рядком на кшталт File ended while scanning use of \textbf чи Paragraph ended before \foo was complete. На відміну від більшості помилок LaTeX, PDF немає взагалі, а номер рядка в повідомленні нерідко вказує на кінець файлу, а не на справжню помилку.

Чому це трапляється

Обидва повідомлення мають одну причину: TeX почав читати щось, що має бути закрите, і дійшов до кінця введення, так і не діждавшись закривального символу. Коли ви пишете \textbf{, TeX збирає все аж до відповідної } як аргумент. Якщо ця дужка так і не з’являється, TeX далі ковтає текст через абзаци й розділи, доки не скінчиться файл. «Runaway argument» означає, що TeX показує вам, що саме він проковтнув. «Emergency stop» означає, що TeX здається, бо без бракуючої частини продовжити не може. Пропущений \end{document}, незакрите середовище або \input неіснуючого файлу призводять до такого самого кінцевого стану.

Як знайти справжнє місце

Не довіряйте номеру рядка: він показує, де в TeX закінчилося введення, а не де почалася неузгодженість. Натомість прочитайте в журналі блок Runaway argument?. Перші слова проковтнутого тексту підкажуть, де в документі почався збій, а рядок File ended while scanning use of ... називає команду, аргумент якої так і не закрили. Знайдіть цю команду поруч із наведеним текстом і порахуйте її дужки.

Якщо журнал не допомагає, шукайте у документі двійковим пошуком. Закоментуйте другу половину основної частини (або обгорніть її в \iffalse ... \fi) і скомпілюйте знову. Якщо помилка зникла, проблема у видаленій половині; продовжуйте ділити навпіл, доки не виокремите проблемний абзац. Це звучить грубо, але у великому документі так знаходять одну пропущену дужку за кілька компіляцій.

Типові винуватці

Перевірте, чи немає { без } поблизу жирного шрифту, курсиву, виносок і підписів, бо ці команди приймають фігурні дужки аргументів, які ви набираєте вручну. Перевірте, що кожен \begin{...} має парний \end{...} з тією самою назвою середовища. Переконайтеся, що файл закінчується \end{document} і що кожен \input та \include вказує на файл, який існує за цим шляхом. Тут допомагають редактори: Oleafly підсвічує парні фігурні дужки й пари середовищ під час набору, і це ловить більшість таких помилок ще до того, як їх побачить компілятор.

Назад до Читання логів