Le programme d'installation et les utilitaires d'interfaçage d'AsTEX sont modulaires,
pour faciliter le débogage et les extensions du système. Pour localiser un composant
défectueux, placez vous dans le menu à partir duquel l'erreur s'est produite, et tapez le
caractère : (deux points). Le nom du composant en cours s'affiche, avec le numéro de
version. Notez-le soigneusement. Notez également la lettre qui permet de lancer
l'option défectueuse (par exemple, la lettre V si l'erreur se produit en sélectionnant
l'option [V] Voir de MenuTeX). Le fichier qui contient le composant suspect a le
même nom que le composant, pour extension bat, et se trouve dans le répertoire
ast\astex. Par exemple, si le nom du composant est Inst0g, le fichier à vérifier
s'appelle ast\astex\inst0g.bat.
Passez ensuite en mode DEBUG. Pour cela, sélectionnez l'option [;] Debug ou tapez le
caractère ; (point virgule) à l'invite du menu où se produit l'erreur (cf. sec. 12.5.1). Vous
pouvez revenir au mode Silencieux en tapant de nouveau le caractère ;. La plupart des
menus donnent accès au mode DEBUG. Si un menu n'a pas d'option de débogage,
revenez dans le menu parent en sélectionnant [Q] Quitter, passez en mode
DEBUG dans ce menu parent, puis retournez dans le menu où se produit
l'anomalie.
Tous les composants sont du texte ordinaire, vous pouvez les éditer avec n'importe quel éditeur de texte. Les sauvegardes doivent êtres faites aussi en texte ordinaire, et non au format de votre éditeur de texte.
La même procédure est bien sûr valable si vous voulez rajouter vous-même une fonctionnalité à l'un des programmes d'AsTEX.
Sur les machines récentes, les affichages sont souvent trop rapides pour pouvoir être examinés en temps réel avec la touche Pause. Pour pouvoir examiner la suite complète des opérations à tête reposée, tapez :
debugout
commande |
dezip comporte une erreur, tapez debugout dezip
menu gnuplot au lieu de dezip menu gnuplot (cf. sec. 13.7) et effectuez les actions
que vous effectueriez en mode normal (par exemple, sélectionnez l'option [I] Installer
puis [Q] Quitter). La totalité des commandes exécutées, qui auraient défilé en mode
DEBUG à l'écran, est sauvegardée dans un fichier de nom debug.out dans le répertoire
courant, et est affichée à l'aide du programme List en fin d'exécution. Vous pouvez
l'examiner à l'aide des touches fléchées, ou vous pouvez quitter List en tapant
sur la touche Echap et examiner le fichier debug.out avec votre éditeur
favori.
Si la sortie vous paraît trop complexe et que vous ne pouvez rien en tirer, envoyez un
rapport d'erreur à l'association en joignant une copie du fichier debug.out
en fichier attaché (courrier électronique) ou sur disquette (courrier postal).
