Le débogueur de Nelson fournit des outils interactifs pour diagnostiquer
et corriger les scripts et fonctions en contrôlant l'exécution et en
inspectant l'état du programme. Le bureau Qt et le bureau web exposent
les mêmes commandes, touches, couleurs de marqueurs et libellés.
Avant de déboguer, enregistrez les fichiers. Les points d'arrêt
appartiennent au fichier enregistré : tant qu'un fichier a des
modifications non enregistrées, ses marqueurs deviennent gris foncé
(invalides) et sont réappliqués sur leurs nouvelles lignes à
l'enregistrement. Enregistrer un fichier pendant une pause termine la
session de débogage.
Points d'arrêt
Cliquez dans la marge gauche à côté du numéro de ligne, ou appuyez sur
F12 sur la ligne, pour poser ou retirer un point d'arrêt standard
(rouge). Un point d'arrêt demandé sur un commentaire, une ligne vide ou
une ligne function glisse vers la ligne exécutable suivante ;
le end d'une boucle ou d'une fonction est une ligne d'arrêt
à part entière. Les lignes else, elseif,
case, otherwise et catch glissent
vers l'instruction suivante.
Un clic droit dans la marge ouvre le menu des points d'arrêt :
Set/Clear Breakpoint, Set/Modify Condition... (point
d'arrêt conditionnel, orange : l'exécution ne s'arrête que si
l'expression est vraie ; une expression en erreur ou non scalaire
affiche un avertissement et s'arrête), Enable/Disable
Breakpoint (gris clair quand désactivé), Enable/Disable All
Breakpoints in File, Clear All Breakpoints in File et
Clear All Breakpoints. Les mêmes opérations existent en ligne de
commande avec dbstop, dbclear et dbstatus ;
l'éditeur et le panneau Breakpoints les suivent.
Pause on Errors (dbstop if error) s'arrête sur une
erreur non attrapée : l'erreur est affichée, puis la ligne ; l'espace de
travail de la fonction fautive reste inspectable et la session se
termine avec Continue, Step ou Stop. Pause on
Caught Errors (dbstop if caught error) s'arrête avant
l'exécution d'un bloc catch ; Continue reprend dans
celui-ci.
Exécution pas à pas
Quand l'exécution s'arrête, le fichier s'ouvre dans l'éditeur, la ligne
courante est surlignée en vert avec une flèche dans la marge, et
l'invite devient K>>. La ligne courante n'a pas encore été
exécutée.
Un arrêt obtenu par une commande tapée dans la console y affiche aussi la
ligne, sous la forme 3 r = r * 2; ; un arrêt obtenu depuis
l'éditeur (Step, Continue, Run to Here, Run) déplace la flèche sans rien
afficher. Le numéro de ligne imprimé est un lien : un clic ouvre l'éditeur
à cette ligne.
Touches : F5 Run, ou Continue pendant une pause ;
F10 Step ; F11 Step In ; Shift+F11 Step Out ;
Shift+F5 Stop (dbquit) ; F12 Set/Clear
Breakpoint ; F9 évaluer la sélection ; F6 Pause, qui
arrête un programme en cours à sa prochaine instruction ; Ctrl+F10
Run to Here, qui exécute jusqu'à la ligne du curseur et s'arrête avant
elle.
Pendant une pause, survoler un nom de variable affiche sa valeur (data
tip) ; le panneau Breakpoints liste tous les points d'arrêt avec leur
condition et leur état, et le panneau Call Stack liste les fonctions
actives (cliquer sur une trame l'ouvre). Chaque fonction a son propre
espace de travail : entrer dans une fonction bascule le navigateur
d'espace de travail sur elle.
Les points d'arrêt durent jusqu'à leur suppression ou la fin de Nelson ;
ils ne sont pas conservés entre deux sessions.
