Arrêt d'urgence et « Runaway argument »

Arrêts fatals dus à des fins manquantes, à des accolades ou à de mauvaises inclusions.

Arrêt d’urgence et « Runaway argument »

Le symptôme

La compilation s’arrête net. Le journal se termine par ! Emergency stop. ou affiche Runaway argument? suivi d’un long passage de votre propre texte, souvent accompagné d’une ligne comme File ended while scanning use of \textbf ou Paragraph ended before \foo was complete. Contrairement à la plupart des erreurs LaTeX, il n’y a aucun PDF, et le numéro de ligne indiqué pointe souvent vers la fin du fichier plutôt que vers la vraie erreur.

Pourquoi cela arrive

Les deux messages viennent du même problème : TeX a commencé à lire quelque chose qui doit être fermé et a atteint la fin de l’entrée avant l’arrivée du jeton fermant. Quand vous écrivez \textbf{, TeX collecte tout jusqu’au } correspondant comme argument. Si cette accolade n’arrive jamais, TeX continue d’avaler du texte, à travers les paragraphes et les sections, jusqu’à la fin du fichier. « Runaway argument » est TeX qui vous montre ce qu’il a avalé. « Emergency stop » est TeX qui abandonne parce qu’il ne peut pas continuer sans l’élément manquant. Un \end{document} manquant, un environnement non fermé ou un \input vers un fichier inexistant aboutissent au même état final.

Comment trouver l’endroit réel

Ne vous fiez pas au numéro de ligne : il indique où TeX a manqué d’entrée, pas où le déséquilibre a commencé. Lisez plutôt le bloc Runaway argument? du journal. Les premiers mots du texte avalé vous disent à quel endroit du document l’emballement a commencé, et la ligne File ended while scanning use of ... nomme la commande dont l’argument n’a jamais été fermé. Cherchez cette commande près du texte cité et comptez ses accolades.

Si le journal n’aide pas, procédez par dichotomie. Mettez en commentaire la seconde moitié du corps (ou enveloppez-la dans \iffalse ... \fi) et recompilez. Si l’erreur disparaît, le problème se trouve dans la moitié retirée ; continuez à diviser en deux jusqu’à isoler le paragraphe fautif. Cela paraît grossier, mais sur un gros document, cela retrouve une simple accolade manquante en une poignée de compilations.

Les suspects habituels

Cherchez un { sans son } autour du gras, de l’italique, des notes de bas de page et des légendes, car ces commandes prennent des accolades d’argument que vous tapez à la main. Vérifiez que chaque \begin{...} a un \end{...} correspondant portant le même nom d’environnement. Assurez-vous que le fichier se termine par \end{document} et que chaque \input et \include désigne un fichier qui existe à ce chemin. Les éditeurs aident ici : Oleafly met en évidence les accolades et les paires d’environnements correspondantes pendant la frappe, ce qui attrape la plupart de ces erreurs avant même que le compilateur ne les voie.

Retour à Savoir lire les logs