27eabecd8cdd3c48832635b2b589b09f16fd35eb
[scilab.git] / scilab / modules / core / help / fr_FR / debugging / debug.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="debug">
3     <refnamediv>
4         <refname>debug</refname>
5         <refpurpose>Environnement de déboggage dans Scilab</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Séquence d'appel</title>
9         <synopsis>
10             debug()
11         </synopsis>
12     </refsynopsisdiv>
13     <refsection>
14         <title>Description</title>
15         <para>
16         Cet environnement sert a débogger un cript Scilab.
17         Après l'appel a <literal>debug()</literal>, vous entrez en mode debug.
18         Ce mode vous permet de manipuler des points d'arrêts,
19         de lancer des exécutions avec arrêt sur erreur,
20         d'exécuter des scripts en mode pas à pas ...
21
22         Une fois que ce mode est actif, l'invite devient <literal>debug> </literal>.
23         </para>
24         <term>Commandes: </term>
25         <listitem>
26             <variablelist>
27                 <varlistentry>
28                     <term>(h)elp: </term>
29                     <para>Affiche l'aide dans la console</para>
30                 </varlistentry>
31                 <varlistentry>
32                     <term>(q)uit: </term>
33                     <para>Quitte l'environnement de déboggage et revient au mode normal de Scilab.</para>
34                 </varlistentry>
35                 <varlistentry>
36                     <term>(w)here or bt: </term>
37                     <para>Affiche la pile d'appel.</para>
38                 </varlistentry>
39                 <varlistentry>
40                     <term>(e)xec: </term>
41                     <term>(r)un: </term>
42                     <para>Exécute une commande.</para>
43                 </varlistentry>
44                 <varlistentry>
45                     <term>(c)ontinue: </term>
46                     <para>Poursuit l'éxécution.</para>
47                 </varlistentry>
48                 <varlistentry>
49                     <term>(a)bort: </term>
50                     <para>Annule l'éxécution.</para>
51                 </varlistentry>
52                 <varlistentry>
53                     <term>step(n)ext or (n)ext: </term>
54                     <para>Poursuit l'éxécution jusqu'a l'expression suivante.</para>
55                 </varlistentry>
56                 <varlistentry>
57                     <term>step(i)n or (i)n: </term>
58                     <para>Poursuit l'éxécution dans la sous fonction.</para>
59                 </varlistentry>
60                 <varlistentry>
61                     <term>step(o)ut or (o)ut: </term>
62                     <para>Poursuit l'éxécution jusqu'a revenir dans la fonction appelante.</para>
63                 </varlistentry>
64                 <varlistentry>
65                     <term>(b)reakpoint or (b)reak: </term>
66                     <synopsis>breakpoint function [line [condition]]</synopsis>
67                     <para>Ajoute un point d'arrêt dans une fonction a une ligne <literal>line</literal></para>
68                     <para>Si une condition est spécifiée, le point d'arrêt ne devient active que si la condition est <literal>%t</literal></para>
69                 </varlistentry>
70                 <varlistentry>
71                     <term>(del)ete: </term>
72                     <synopsis>delete [n]</synopsis>
73                     <para>Supprime tous les points d'arrêt.</para>
74                     <para>Si n est spécifié, supprime le point d'arrêt #n</para>
75                 </varlistentry>
76                 <varlistentry>
77                     <term>enable: </term>
78                     <synopsis>enable [n]</synopsis>
79                     <para>Active tous les points d'arrêt.</para>
80                     <para>Si n est spécifié, active le point d'arrêt #n</para>
81                 </varlistentry>
82                 <varlistentry>
83                     <term>disable: </term>
84                     <synopsis>disable [n]</synopsis>
85                     <para>Désactive tous les points d'arrêt.</para>
86                     <para>Si n est spécifié, désavtive le point d'arrêt #n</para>
87                 </varlistentry>
88                 <varlistentry>
89                     <term>(s)how: </term>
90                     <synopsis>show [n]</synopsis>
91                     <para>Affiche tous les information sur les points d'arrêt.</para>
92                     <para>Si n est spécifié, affiche les information du point d'arrêt #n</para>
93                 </varlistentry>
94             </variablelist>
95         </listitem>
96     </refsection>
97     <refsection>
98         <title>Examples</title>
99         <programlisting role="example"><![CDATA[
100 //fonction de surcharge de la fonction cosinus pour les chaînes de caractères
101 function v = %c_cos(val)
102     printf("val : %s\n", val);
103     v = cos(evstr(val));
104 endfunction
105
106 //appelant
107 function a = test_debug()
108     b = cos("%pi");
109     a = b * 3;
110 endfunction
111
112 debug
113 break test_debug
114 exec test_debug
115 where
116 stepin
117 disp val
118 continue
119 quit
120  ]]></programlisting>
121         <programlisting role="example"><![CDATA[
122 function v = compute(val)
123     v = 1;
124     for i=1:val
125         v = v * i;
126     end
127 endfunction
128
129 debug
130 break compute 4 "i == 5"
131 exec compute(10)
132 disp val
133 disp i
134 disp v
135 continue
136 quit
137  ]]></programlisting>
138     </refsection>
139     
140     <refsection>
141         <title>History</title>
142         <revhistory>
143             <revision>
144                 <revnumber>6.0.0</revnumber>
145                 <revremark>Nouvelle version: Interface console avec le debugger de Scilab 6.</revremark>
146             </revision>
147         </revhistory>
148     </refsection>
149 </refentry>