a87652fe2bd51f61bf586b25f325cf8d8c7842df
[scilab.git] / scilab / modules / core / help / fr_FR / scilab.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:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="scilab" xml:lang="fr">
3     <refnamediv>
4         <refname>scilab</refname>
5         <refpurpose>Script principal d'exécution de Scilab et de divers
6             outils (GNU/Linux, Unix et Mac OS X)
7         </refpurpose>
8     </refnamediv>
9     <refsynopsisdiv>
10         <title>Séquence d'appel</title>
11         <synopsis>scilab &lt;Options&gt;
12             scilab-adv-cli &lt;Options&gt;
13             scilab-cli &lt;Options&gt;
14         </synopsis>
15     </refsynopsisdiv>
16     <refsection role="arguments">
17         <title>Paramètres</title>
18         <variablelist>
19             <varlistentry>
20                 <term>-args arguments</term>
21                 <listitem>
22                     <para>si cette option est présente des arguments sont passés à
23                         Scilab. Ils peuvent être récupérés par la fonction
24                         <literal>
25                             <link linkend="sciargs">sciargs</link>
26                         </literal>
27                         .Les arguments multiples
28                         doivent être passés dans chaîne de caractères les contenant, séparés
29                         par des espaces <literal>scilab -args 'foo1 foo2';</literal>.
30                         Sans cette option, les arguments inconnus ne seront pas acceptés.
31                     </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>-display Display</term>
36                 <listitem>
37                     <para>Cette option n'est valide que pour les version basées sur
38                         Xwindow, elle peut alors être utilisée pour specifier un server X.
39                         La valeur par défaut est unix:0.0
40                     </para>
41                     <para>
42                         <literal>-display</literal> peut être remplacé par
43                         <literal>-d</literal>
44                     </para>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>-debug</term>
49                 <listitem>
50                     <para>Lance Scilab sous gdb (Unix/Linux/Mac OS X seulement).</para>
51                     <para>Définir la variable SCILAB_GDB_OPT pour ajouter des options
52                         supplémentaire à gdb.
53                     </para>
54                     <para>Conseil: Utilisez cette option à partir de l'arborescence
55                         source de Scilab
56                     </para>
57                 </listitem>
58             </varlistentry>
59             <varlistentry>
60                 <term>-debug-kdbg</term>
61                 <listitem>
62                     <para>Lance Scilab sous kdbg (Unix/Linux/Mac OS X seulement).</para>
63                     <para>Conseil: Utilisez cette option à partir de l'arborescence
64                         source de Scilab
65                     </para>
66                 </listitem>
67             </varlistentry>
68             <varlistentry>
69                 <term>-profiling</term>
70                 <listitem>
71                     <para>Lance Scilab sous valgrind (Unix/Linux/Mac OS X seulement).</para>
72                     <para>Définir la variable SCILAB_VALGRIND_OPT pour ajouter des
73                         options supplémentaire à valgrind (et surcharger les options de
74                         valgrind existantes).
75                     </para>
76                     <para>Conseil: Utilisez cette option à partir de l'arborescence
77                         source de Scilab
78                     </para>
79                 </listitem>
80             </varlistentry>
81             <varlistentry>
82                 <term>-profiling-visu</term>
83                 <listitem>
84                     <para>Lance Scilab sous callgrind (Unix/Linux/Mac OS X seulement).</para>
85                     <para>Définir la variable SCILAB_VALGRIND_OPT pour ajouter des
86                         options supplémentaires à callgrind (et surcharger les options de
87                         callgrind existante).
88                     </para>
89                     <para>Conseil: Utilisez cette option à partir de l'arborescence
90                         source de Scilab
91                     </para>
92                 </listitem>
93             </varlistentry>
94             <varlistentry>
95                 <term>-electric-fence</term>
96                 <listitem>
97                     <para>Lance Scilab sous Electric Fence (Unix/Linux/Mac OS X seulement).</para>
98                     <para>Conseil: Utilisez cette option à partir de l'arborescence
99                         source de Scilab
100                     </para>
101                 </listitem>
102             </varlistentry>
103             <varlistentry>
104                 <term>-e Instruction</term>
105                 <listitem>
106                     <para>si cette option est présente l'instruction
107                         <literal>Instruction</literal> est exécutée dans Scilab
108                         immédiatement après les fichiers startup.
109                     </para>
110                     <para>Plusieurs commandes peuvent être indiquées à la suite avec
111                         l'option -e:
112                     </para>
113                     <para>
114                         <programlisting>scilab-cli -e  "a=1+%i; aPlusPi=a+%pi; disp(aPlusPi);exit;" -nb</programlisting>
115                     </para>
116                 </listitem>
117             </varlistentry>
118             <varlistentry>
119                 <term>-f Fichier</term>
120                 <listitem>
121                     <para>
122                         si cette option est présente le script <literal>Fichier</literal>
123                         est exécuté dans Scilab mmédiatement après les fichiers startup. -f
124                         et -e ne peuvent pas être utilisée en même temps.
125                     </para>
126                     <para>Un fichier avec l'extension .xcos sera ouvert par Xcos.</para>
127                 </listitem>
128             </varlistentry>
129             <varlistentry>
130                 <term>-quit</term>
131                 <listitem>
132                     <para>Cette option force Scilab à quitter la session après l'exécution des instructions
133                     données par l'option <literal>-e</literal> ou par le script indiqué via l'option
134                     <literal>-f</literal>, y compris en cas d'erreur d'exécution.
135                     Cette option doit toujours être utilisée en mode batch. Elle est ignorée lorsque
136                     l'option <literal>-e</literal> ou <literal>-f</literal> n'est pas utilisée.
137                     </para>
138                 </listitem>
139             </varlistentry>
140             <varlistentry>
141                 <term>-l lang</term>
142                 <listitem>
143                     <para>Cette option permet de sélectionner la langue de
144                         l'utilisateur. <emphasis>lang</emphasis> peut avoir les valeurs:
145                         <emphasis>ca_ES de_DE en_US es_ES fr_FR ja_JP pt_BR ru_RU zh_CN
146                             zh_TW
147                         </emphasis>
148                         (à partir de Scilab 5.2).
149                     </para>
150                     <para>
151                         Les valeurs possible pour sont <literal>-l fr</literal> pour
152                         sélectionner le francais et <literal>-l en</literal> pour
153                         sélectionner l'anglais. La langue par défaut est l'anglais, ce
154                         défaut est fixé dans le fichier
155                         <literal>scilab.start</literal>.
156                     </para>
157                     <para>Avec certains systèmes, la compilation des locales peut être
158                         nécessaire pour rendre correctement les polices UTF-8.
159                     </para>
160                     <para>Scilab peut être aussi appellé de la manière suivante:</para>
161                     <programlisting>LANG=ja_JP scilab
162                         # équivalent à
163                         scilab -l ja_JP
164                     </programlisting>
165                 </listitem>
166             </varlistentry>
167             <varlistentry>
168                 <term>-nb</term>
169                 <listitem>
170                     <para>si cette option est présente le message de chargement de Scilab n'est pas affiché.
171                     </para>
172                 </listitem>
173             </varlistentry>
174             <varlistentry>
175                 <term>-ns</term>
176                 <listitem>
177                     <para>si cette option est présente le script de démarrage
178                         "principal" <literal>SCI/etc/scilab.start</literal> ainsi que les
179                         fichiers de démarrage "utilisateur"
180                         <literal>SCIHOME/.scilab</literal> et
181                         <literal>SCIHOME/scilab.ini</literal> ne sont pas pas
182                         exécutés.
183                     </para>
184                     <para>L'utilisation de cette option désactivera de nombreuses
185                         fonctionnalités de Scilab (Ne l'utilisez que si vous savez ce que
186                         vous faites).
187                     </para>
188                 </listitem>
189             </varlistentry>
190             <varlistentry>
191                 <term>-nouserstartup</term>
192                 <listitem>
193                     <para>Si cette option est fournie, les fichiers de démarrage
194                         "utilisateur" <literal>SCIHOME/.scilab</literal>,
195                         <literal>SCIHOME/scilab.ini</literal> ne sont pas exécutés.
196                     </para>
197                 </listitem>
198             </varlistentry>
199             <varlistentry>
200                 <term>-noatomsautoload</term>
201                 <listitem>
202                     <para>Si cette option est fournie, les modules ATOMS précédemment installés ne sont pas chargés durant cette session.</para>
203                 </listitem>
204             </varlistentry>
205             <varlistentry>
206                 <term>-nw</term>
207                 <listitem>
208                     <para>si cette option est présente Scilab est lancé en tant que
209                         interpreteur de commande avancé (graphiques, fonctionnalité de
210                         construction de l'aide, etc).
211                     </para>
212                     <para>The option peut être utilisé avec les arguments -f ou
213                         -e.
214                     </para>
215                     <para>A partir de la version 5.2 de Scilab:</para>
216                     <itemizedlist>
217                         <listitem>
218                             <para>La distribution de Scilab fournit aussi un binaire dédié
219                                 faisant la même chose que l'option <emphasis>-nw</emphasis>:
220                                 <emphasis>scilab-adv-cli</emphasis> (Scilab Advanced Command
221                                 Line Interpreter).
222                             </para>
223                         </listitem>
224                         <listitem>
225                             <para>Les fonctionnalités de pipe sont accessibles pour tous les
226                                 systèmes d'exploitations (voir les examples pour plus de
227                                 détails)
228                             </para>
229                         </listitem>
230                     </itemizedlist>
231                 </listitem>
232             </varlistentry>
233             <varlistentry>
234                 <term>-nwni / -nogui</term>
235                 <listitem>
236                     <para>si cette option est présente Scilab est lancé en tant que
237                         interpreteur de commande (sans graphique, ni fonctionnalité de
238                         construction de l'aide, etc).
239                     </para>
240                     <para>The option peut être utilisé avec les arguments -f ou
241                         -e.
242                     </para>
243                     <para>A partir de la version 5.2 de Scilab:</para>
244                     <itemizedlist>
245                         <listitem>
246                             <para>La distribution de Scilab fournit aussi un binaire dédié
247                                 faisant la même chose que l'option <emphasis>-nw</emphasis>:
248                                 <emphasis>scilab-cli</emphasis> (Scilab Command Line
249                                 Interpreter).
250                             </para>
251                         </listitem>
252                         <listitem>
253                             <para>Les fonctionnalités de pipe sont accessibles pour tous les
254                                 systèmes d'exploitations (voir les examples pour plus de
255                                 détails)
256                             </para>
257                         </listitem>
258                     </itemizedlist>
259                     <para>Ce mode ne charge pas la Machine Virtuelle Java (plus rapide à
260                         démarer et consomme moins de mémoire).
261                     </para>
262                 </listitem>
263             </varlistentry>
264             <varlistentry>
265                 <term>--texmacs</term>
266                 <listitem>
267                     <para>Cette option est réservée pour TeXMacs.</para>
268                     <para>Veuillez installer le module ATOMS atomsInstall('texmacs')</para>
269                 </listitem>
270             </varlistentry>
271             <varlistentry>
272                 <term>-version</term>
273                 <listitem>
274                     <para>Cette option affiche la version de Scilab.</para>
275                 </listitem>
276             </varlistentry>
277         </variablelist>
278     </refsection>
279     <refsection role="description">
280         <title>Description des variables d'environnement</title>
281         <variablelist>
282             <varlistentry>
283                 <term>SCIVERBOSE</term>
284                 <listitem>
285                     <para>Si cette variable d'environnement est présente, le script de démarrage de Scilab affichera les informations de debug. Principalement utilisée pour du debug ou le report de bugs.</para>
286                 </listitem>
287             </varlistentry>
288             <varlistentry>
289                 <term>JAVA_HOME</term>
290                 <listitem>
291                     <para>
292                         Indique quelle version de Java utiliser. Par exemple, <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> démarrera Scilab avec la version 7 de Java.
293                     </para>
294                 </listitem>
295             </varlistentry>
296             <varlistentry>
297                 <term>SCI_DISABLE_TK</term>
298                 <listitem>
299                     <para>Désactive les fonctionnalités Tk (mais pas Tcl)</para>
300                 </listitem>
301             </varlistentry>
302             <varlistentry>
303                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
304                 <listitem>
305                     <para>Démarre Java en mode Headless (ie sans les fonctionnalités graphiques).
306                     </para>
307                 </listitem>
308             </varlistentry>
309         </variablelist>
310     </refsection>
311     <refsection role="description">
312         <title>Java Virtual Machine options</title>
313         <para>A partir de la version 5.0 de Scilab, l'interface graphique et le
314             système de génération de la documentation sont basés sur des
315             fonctionnalités Java. Dans certains cas, il peut être intéressant de
316             modifier les options de la JVM (Java Virtual Machine).
317         </para>
318         <para>Ces options sont accessibles via le fichier
319             <emphasis>jvm_options.xml</emphasis>.
320         </para>
321         <para>Dans les version 5.0.X et 5.1.X, ce fichier est accessible dans
322             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>
323         </para>
324         <para>Dans les versions &gt;= 5.2.0, le fichier est accessible sous
325             <emphasis>
326                 etc/jvm_options.xml<emphasis> </emphasis>
327             </emphasis>
328         </para>
329         <para>
330             <emphasis>
331                 <emphasis>Par défault, les trois options suivantes sont
332                     facilement accessibles à partir du fichier de
333                     configuration:
334                 </emphasis>
335             </emphasis>
336         </para>
337         <variablelist>
338             <varlistentry>
339                 <term>-XmxXXXm</term>
340                 <listitem>
341                     <para>Cette option indique la quantité de mémoire mise à disposition
342                         de la machine virtuelle Java. Par défaut, la valeur est de 256M. Si
343                         vous changez cette valeur, assurez vous que cette valeur ne dépasse
344                         pas la quantité de mémoire accessible sur le système.
345                     </para>
346                 </listitem>
347             </varlistentry>
348             <varlistentry>
349                 <term>-Djava.compiler=JIT</term>
350                 <listitem>
351                     <para>Avec la valeur JIT, le compilateur Java Just In Time (JIT) est
352                         activé. Il est activé par défault. <emphasis>NONE</emphasis>
353                         désactive le JIT et diminue de manière importante les
354                         performances.
355                     </para>
356                 </listitem>
357             </varlistentry>
358             <varlistentry>
359                 <term>-verbose:jni / -Xcheck:jni</term>
360                 <listitem>
361                     <para>Ces options activent de nombreuses vérifications, message de
362                         débug et autres contrôles sur les appels JNI (appel natif Java). Ces
363                         options sont utiles pour le débuggage et désactivée par défaut à
364                         cause de l'impact sur les performances.
365                     </para>
366                 </listitem>
367             </varlistentry>
368         </variablelist>
369         <para>
370             De nombreuses options sont disponibles. Elles peuvent améliorer les performances, changer le rendu graphique, la gestion de la mémoire... Voir: <ulink url="http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html">http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html</ulink>
371         </para>
372     </refsection>
373     <refsection role="examples">
374         <title>Exemples</title>
375         <programlisting role="example">
376             # Lançons Scilab en mode profilage sans qu'un gdb soit lancé à chaque SIGSEGV.
377             # On est sous Bash
378             export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
379             scilab -profiling
380
381             # Lançons Scilab en mode debug sans s'arrêter à chaque SIGSEGV
382             # D'abord écrivons un petit fichier de commandes
383             echo "handle SIGSEGV nostop" &amp;gt; debug.txt
384             # On règle l'option de gdb
385             # On est sous Bash
386             export SCILAB_GDB_OPT="--command=debug.txt"
387             # Lançons Scilab en mode debug
388             scilab -debug
389         </programlisting>
390         <programlisting role="example-cli">
391             # Sous GNU/Linux, Mac OS X or Unix:
392             $ echo "disp(%pi)"|scilab-cli
393             ou
394             $ echo "disp(%pi)"|scilab -nwni
395
396             # Ouvre uniquement la fenêtre d'aide Scilab:
397             $ scilab-adv-cli -e "help()"
398             or
399             $ scilab -nw -e "help()"
400
401
402             # Scilab utilisé en tant que moteur de scripting
403             echo "if 1&lt;&gt;2 then exit(99) end"|scilab-cli
404             echo $?
405         </programlisting>
406     </refsection>
407     <refsection role="see also">
408         <title>Voir aussi</title>
409         <simplelist type="inline">
410             <member>
411                 <link linkend="exit">exit</link>
412             </member>
413             <member>
414                 <link linkend="startup">startup</link>
415             </member>
416         </simplelist>
417     </refsection>
418     <refsection role="history">
419         <title>Historique</title>
420         <revhistory>
421             <revision>
422                 <revnumber>5.4.0</revnumber>
423                 <revremark>-noatomsautoload ajouté.</revremark>
424             </revision>
425             <revision>
426                 <revnumber>5.4.1</revnumber>
427                 <revremark>scinotes et xcos peuvent maintenant être démarrés en ligne de commande. Voir le SEP #87.</revremark>
428             </revision>
429             <revision>
430                 <revnumber>6.0.0</revnumber>
431                 <revremark>
432                     Option <literal>-quit</literal> ajoutée. Option <literal>-mem</literal> supprimée.
433                 </revremark>
434             </revision>
435         </revhistory>
436     </refsection>
437 </refentry>