f252d65dcc53f98fcfdceee086be4661a47bb653
[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>
17         <title>Description</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>-l lang</term>
131                 <listitem>
132                     <para>Cette option permet de sélectionner la langue de
133                         l'utilisateur. <emphasis>lang</emphasis> peut avoir les valeurs:
134                         <emphasis>ca_ES de_DE en_US es_ES fr_FR ja_JP pt_BR ru_RU zh_CN
135                             zh_TW
136                         </emphasis>
137                         (à partir de Scilab 5.2).
138                     </para>
139                     <para>
140                         Les valeurs possible pour sont <literal>-l fr</literal> pour
141                         sélectionner le francais et <literal>-l en</literal> pour
142                         sélectionner l'anglais. La langue par défaut est l'anglais, ce
143                         défaut est fixé dans le fichier
144                         <literal>scilab.start</literal>.
145                     </para>
146                     <para>Avec certains systèmes, la compilation des locales peut être
147                         nécessaire pour rendre correctement les polices UTF-8.
148                     </para>
149                     <para>Scilab peut être aussi appellé de la manière suivante:</para>
150                     <programlisting>LANG=ja_JP scilab
151                         # équivalent à
152                         scilab -l ja_JP
153                     </programlisting>
154                 </listitem>
155             </varlistentry>
156             <varlistentry>
157                 <term>-nb</term>
158                 <listitem>
159                     <para>si cette option est présente le message de chargement de Scilab n'est pas affiché.
160                     </para>
161                 </listitem>
162             </varlistentry>
163             <varlistentry>
164                 <term>-ns</term>
165                 <listitem>
166                     <para>si cette option est présente le script de démarrage
167                         "principal" <literal>SCI/etc/scilab.start</literal> ainsi que les
168                         fichiers de démarrage "utilisateur"
169                         <literal>SCIHOME/.scilab</literal> et
170                         <literal>SCIHOME/scilab.ini</literal> ne sont pas pas
171                         exécutés.
172                     </para>
173                     <para>L'utilisation de cette option désactivera de nombreuses
174                         fonctionnalités de Scilab (Ne l'utilisez que si vous savez ce que
175                         vous faites).
176                     </para>
177                 </listitem>
178             </varlistentry>
179             <varlistentry>
180                 <term>-nouserstartup</term>
181                 <listitem>
182                     <para>Si cette option est fournie, les fichiers de démarrage
183                         "utilisateur" <literal>SCIHOME/.scilab</literal>,
184                         <literal>SCIHOME/scilab.ini</literal> ne sont pas exécutés.
185                     </para>
186                 </listitem>
187             </varlistentry>
188             <varlistentry>
189                 <term>-noatomsautoload</term>
190                 <listitem>
191                     <para>Si cette option est fournie, les modules ATOMS précédemment installés ne sont pas chargés durant cette session.</para>
192                 </listitem>
193             </varlistentry>
194             <varlistentry>
195                 <term>-nw</term>
196                 <listitem>
197                     <para>si cette option est présente Scilab est lancé en tant que
198                         interpreteur de commande avancé (graphiques, fonctionnalité de
199                         construction de l'aide, etc).
200                     </para>
201                     <para>The option peut être utilisé avec les arguments -f ou
202                         -e.
203                     </para>
204                     <para>A partir de la version 5.2 de Scilab:</para>
205                     <itemizedlist>
206                         <listitem>
207                             <para>La distribution de Scilab fournit aussi un binaire dédié
208                                 faisant la même chose que l'option <emphasis>-nw</emphasis>:
209                                 <emphasis>scilab-adv-cli</emphasis> (Scilab Advanced Command
210                                 Line Interpreter).
211                             </para>
212                         </listitem>
213                         <listitem>
214                             <para>Les fonctionnalités de pipe sont accessibles pour tous les
215                                 systèmes d'exploitations (voir les examples pour plus de
216                                 détails)
217                             </para>
218                         </listitem>
219                     </itemizedlist>
220                 </listitem>
221             </varlistentry>
222             <varlistentry>
223                 <term>-nwni / -nogui</term>
224                 <listitem>
225                     <para>si cette option est présente Scilab est lancé en tant que
226                         interpreteur de commande (sans graphique, ni fonctionnalité de
227                         construction de l'aide, etc).
228                     </para>
229                     <para>The option peut être utilisé avec les arguments -f ou
230                         -e.
231                     </para>
232                     <para>A partir de la version 5.2 de Scilab:</para>
233                     <itemizedlist>
234                         <listitem>
235                             <para>La distribution de Scilab fournit aussi un binaire dédié
236                                 faisant la même chose que l'option <emphasis>-nw</emphasis>:
237                                 <emphasis>scilab-cli</emphasis> (Scilab Command Line
238                                 Interpreter).
239                             </para>
240                         </listitem>
241                         <listitem>
242                             <para>Les fonctionnalités de pipe sont accessibles pour tous les
243                                 systèmes d'exploitations (voir les examples pour plus de
244                                 détails)
245                             </para>
246                         </listitem>
247                     </itemizedlist>
248                     <para>Ce mode ne charge pas la Machine Virtuelle Java (plus rapide à
249                         démarer et consomme moins de mémoire).
250                     </para>
251                 </listitem>
252             </varlistentry>
253             <varlistentry>
254                 <term>--texmacs</term>
255                 <listitem>
256                     <para>Cette option est réservée pour TeXMacs.</para>
257                     <para>Veuillez installer le module ATOMS atomsInstall('texmacs')</para>
258                 </listitem>
259             </varlistentry>
260             <varlistentry>
261                 <term>-version</term>
262                 <listitem>
263                     <para>Cette option affiche la version de Scilab.</para>
264                 </listitem>
265             </varlistentry>
266         </variablelist>
267     </refsection>
268     <refsection>
269         <title>Description des variables d'environnement</title>
270         <variablelist>
271             <varlistentry>
272                 <term>SCIVERBOSE</term>
273                 <listitem>
274                     <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>
275                 </listitem>
276             </varlistentry>
277             <varlistentry>
278                 <term>JAVA_HOME</term>
279                 <listitem>
280                     <para>
281                         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.
282                     </para>
283                 </listitem>
284             </varlistentry>
285             <varlistentry>
286                 <term>SCI_DISABLE_TK</term>
287                 <listitem>
288                     <para>Désactive les fonctionnalités Tk (mais pas Tcl)</para>
289                 </listitem>
290             </varlistentry>
291             <varlistentry>
292                 <term>SCI_JAVA_ENABLE_HEADLESS</term>
293                 <listitem>
294                     <para>Démarre Java en mode Headless (ie sans les fonctionnalités graphiques).
295                     </para>
296                 </listitem>
297             </varlistentry>
298         </variablelist>
299     </refsection>
300     <refsection>
301         <title>Java Virtual Machine options</title>
302         <para>A partir de la version 5.0 de Scilab, l'interface graphique et le
303             système de génération de la documentation sont basés sur des
304             fonctionnalités Java. Dans certains cas, il peut être intéressant de
305             modifier les options de la JVM (Java Virtual Machine).
306         </para>
307         <para>Ces options sont accessibles via le fichier
308             <emphasis>jvm_options.xml</emphasis>.
309         </para>
310         <para>Dans les version 5.0.X et 5.1.X, ce fichier est accessible dans
311             <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>
312         </para>
313         <para>Dans les versions &gt;= 5.2.0, le fichier est accessible sous
314             <emphasis>
315                 etc/jvm_options.xml<emphasis> </emphasis>
316             </emphasis>
317         </para>
318         <para>
319             <emphasis>
320                 <emphasis>Par défault, les trois options suivantes sont
321                     facilement accessibles à partir du fichier de
322                     configuration:
323                 </emphasis>
324             </emphasis>
325         </para>
326         <variablelist>
327             <varlistentry>
328                 <term>-XmxXXXm</term>
329                 <listitem>
330                     <para>Cette option indique la quantité de mémoire mise à disposition
331                         de la machine virtuelle Java. Par défaut, la valeur est de 256M. Si
332                         vous changez cette valeur, assurez vous que cette valeur ne dépasse
333                         pas la quantité de mémoire accessible sur le système.
334                     </para>
335                 </listitem>
336             </varlistentry>
337             <varlistentry>
338                 <term>-Djava.compiler=JIT</term>
339                 <listitem>
340                     <para>Avec la valeur JIT, le compilateur Java Just In Time (JIT) est
341                         activé. Il est activé par défault. <emphasis>NONE</emphasis>
342                         désactive le JIT et diminue de manière importante les
343                         performances.
344                     </para>
345                 </listitem>
346             </varlistentry>
347             <varlistentry>
348                 <term>-verbose:jni / -Xcheck:jni</term>
349                 <listitem>
350                     <para>Ces options activent de nombreuses vérifications, message de
351                         débug et autres contrôles sur les appels JNI (appel natif Java). Ces
352                         options sont utiles pour le débuggage et désactivée par défaut à
353                         cause de l'impact sur les performances. 
354                     </para>
355                 </listitem>
356             </varlistentry>
357         </variablelist>
358         <para>
359             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>
360         </para>
361     </refsection>
362     <refsection>
363         <title>Examples</title>
364         <programlisting role="example"> 
365             # Lançons Scilab en mode profilage sans qu'un gdb soit lancé à chaque SIGSEGV.
366             # On est sous Bash
367             export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
368             scilab -profiling
369             
370             # Lançons Scilab en mode debug sans s'arrêter à chaque SIGSEGV
371             # D'abord écrivons un petit fichier de commandes
372             echo "handle SIGSEGV nostop" &amp;gt; debug.txt
373             # On règle l'option de gdb
374             # On est sous Bash
375             export SCILAB_GDB_OPT="--command=debug.txt"
376             # Lançons Scilab en mode debug
377             scilab -debug
378         </programlisting>
379         <programlisting role="example-cli">
380             # Sous GNU/Linux, Mac OS X or Unix:
381             $ echo "disp(%pi)"|scilab-cli
382             ou
383             $ echo "disp(%pi)"|scilab -nwni
384             
385             # Ouvre uniquement la fenêtre d'aide Scilab:
386             $ scilab-adv-cli -e "help()"
387             or
388             $ scilab -nw -e "help()"
389             
390             
391             # Scilab utilisé en tant que moteur de scripting
392             echo "if 1&lt;&gt;2 then exit(99) end"|scilab-cli
393             echo $? 
394         </programlisting>
395     </refsection>
396     <refsection role="see also">
397         <title>See Also</title>
398         <simplelist type="inline">
399             <member>
400                 <link linkend="exit">exit</link>
401             </member>
402         </simplelist>
403     </refsection>
404     <refsection>
405         <title>History</title>
406         <revhistory>
407             <revision>
408                 <revnumber>5.4.0</revnumber>
409                 <revremark>-noatomsautoload ajouté.</revremark>
410             </revision>
411         </revhistory>
412     </refsection>
413 </refentry>