Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
1_generalites:erreurs:interpreter_les_messages_d_erreur2 [2021/02/05 21:25] – [Utiliser les traces] FInalement, non dbitouze2_programmation:erreurs:interpreter_les_messages_d_erreur2 [2022/09/22 14:14] (Version actuelle) – Insertion d'espace de longueur nulle en vue de conversion dbitouze
Ligne 1: Ligne 1:
-====== Comment traiter les erreurs ? ======+====== Comment traiter les erreurs? ======
  
- +<latex>\TeX</latex> étant un processeur de macro (//macroprocessor//), ces messages d'erreur restent souvent difficiles à comprendre ; c'est une propriété (apparemment invariante) de ce type de programme. Knuth met en lumière le problème dans le <latex>\TeX</latex>book en suggérant que vous acquériez les compétences d'investigation d'un Sherlock Holmes des temps modernes pour traiter ces erreurs. Bien que cette approche présente un certain charme romantique, ce n'est pas une bonne solution pour un simple utilisateur de <latex>\TeX</latex> et <latex>\LaTeX</latex>. Cette réponse (tirée en partie d'un [[http://tug.org/TUGboat/tb16-4/tb49rahtz.pdf|article de Sebastian Rahtz]] dans le [[http://tug.org/TUGboat/Contents/contents16-4.html|TUGboat volume 16, n°4]]) propose des lignes de conduite pour gérer les rapports d'erreur de <latex>\TeX</latex> et est suivie d'autres réponses sur les erreurs courantes (mais embarrassantes) que vous pourriez rencontrer. 
-<latex>\TeX</latex> étant un processeur de macro (//macroprocessor//), ces messages d'erreur restent souvent difficiles à comprendre ; c'est une propriété (apparemment invariante) de ce type de programme. Knuth met en lumière le problème dans le <latex>\TeX</latex>book en suggérant que vous acquériez les compétences d'investigation d'un Sherlock Holmes des temps modernes pour traiter ces erreurs. Bien que cette approche présente un certain charme romantique, ce n'est pas une bonne solution pour un simple utilisateur de <latex>\TeX</latex> et <latex>\LaTeX</latex>. Cette réponse (tirée en partie d'un [[http://tug.org/TUGboat/tb16-4/tb49rahtz.pdf|article de Sebastian Rahtz]] dans le [[http://tug.org/TUGboat/Contents/contents16-4.html|TUGboat volume 16, n°4]]) propose des lignes de conduite pour gérer les rapports d'erreur de <latex>\TeX</latex> et est suivie d'autres réponses sur les erreurs courantes (mais embarrassantes) que vous pourriez rencontrer. +
  
 ===== Lire les erreurs ===== ===== Lire les erreurs =====
  
-Les messages d'erreur peuvent sembler énigmatiques à première vue mais ils contiennent souvent une indication sur la nature du problème. Voir la question sur [[1_generalites:erreurs:structure_d_un_message_d_erreur|la structure des erreurs]] pour plus de détails.+Les messages d'erreur peuvent sembler énigmatiques à première vue mais ils contiennent souvent une indication sur la nature du problème. Voir la question sur [[2_programmation:erreurs:structure_d_un_message_d_erreur|la structure des erreurs]] pour plus de détails.
  
 ===== Lire le fichier journal ===== ===== Lire le fichier journal =====
Ligne 24: Ligne 23:
 ===== Utiliser les traces ===== ===== Utiliser les traces =====
  
-En dernier recours, l'utilisation de trace (//tracing//) peut être une technique très performante. Lire une trace intégrale de <latex>\TeX</latex> ou <latex>\LaTeX</latex> demande une sacrée constitution mais, une fois que vous savez le faire, la trace peut vous mener rapidement à la source d'un problème. Vous devez avoir lu une bonne part du <latex>\TeX</latex>book (voir [[1_generalites:documentations_payantes:documents_sur_tex|Que lire sur TeX et Plain TeX ?]]) pour bien comprendre une trace.+En dernier recours, l'utilisation de trace (//tracing//) peut être une technique très performante. Lire une trace intégrale de <latex>\TeX</latex> ou <latex>\LaTeX</latex> demande une sacrée constitution mais, une fois que vous savez le faire, la trace peut vous mener rapidement à la source d'un problème. Vous devez avoir lu une bonne part du <latex>\TeX</latex>book (voir [[1_generalites:documentation:livres:documents_sur_tex|Que lire sur TeX et Plain TeX ?]]) pour bien comprendre une trace.
 v v
 La commande ''\tracingall'' génère la version la plus exhaustive de la trace. Elle transfère aussi le document de sortie vers le terminal interactif, ce qui constitue, quelque part, un mélange pas très heureux (dans la mesure où la sortie générée est généralement vaste, toutes les traces à l'exception des plus simples demandent à être analysée dans un éditeur de texte séparément).   La commande ''\tracingall'' génère la version la plus exhaustive de la trace. Elle transfère aussi le document de sortie vers le terminal interactif, ce qui constitue, quelque part, un mélange pas très heureux (dans la mesure où la sortie générée est généralement vaste, toutes les traces à l'exception des plus simples demandent à être analysée dans un éditeur de texte séparément).  
Ligne 34: Ligne 33:
 ===== Ne pas paniquer ! ===== ===== Ne pas paniquer ! =====
  
-Le meilleur conseil à donner aux personnes faisant face à des erreurs <latex>\TeX</latex> reste de ne pas paniquer : la plupart des erreurs sont évidentes lorsque vous retournez à la ligne de votre code source que vous indique <latex>\TeX</latex>. Si cela ne marche pas, les autres réponses données dans cette FAQ traite de certaines des erreurs les plus bizarres que vous puissiez rencontrer. Vous ne devriez donc pas avoir besoin d'appeler à l'[[1_generalites/documentations_libres/listes_de_discussion|aide du grand public]] mais, si c'est le cas, pensez bien à fournir un contexte complet (voir ''errorcontextlines'' ci-dessus) à vos interlocuteurs.+Le meilleur conseil à donner aux personnes faisant face à des erreurs <latex>\TeX</latex> reste de ne pas paniquer : la plupart des erreurs sont évidentes lorsque vous retournez à la ligne de votre code source que vous indique <latex>\TeX</latex>. Si cela ne marche pas, les autres réponses données dans cette FAQ traite de certaines des erreurs les plus bizarres que vous puissiez rencontrer. Vous ne devriez donc pas avoir besoin d'appeler à l'[[1_generalites:documentation:listes_de_discussion|aide du grand public]] mais, si c'est le cas, pensez bien à fournir un contexte complet (voir ''errorcontextlines'' ci-dessus) à vos interlocuteurs.
  
 ----- -----
Ligne 43: Ligne 42:
 metatag-og:site_name=(FAQ LaTeX francophone) metatag-og:site_name=(FAQ LaTeX francophone)
 }} }}
 +
2_programmation/erreurs/interpreter_les_messages_d_erreur2.1612560321.txt.gz · Dernière modification : 2021/02/05 21:25 de dbitouze
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0