Scilab cli: add a "--timeout delay" argument
[scilab.git] / scilab / modules / development_tools / help / fr_FR / test_run.xml
index 61dc3fe..4944473 100644 (file)
@@ -5,11 +5,14 @@
  * Copyright (C) 2009-2011 - DIGITEO - Michael Baudin
  * Copyright (C) 2013 - Scilab Enterprises - Paul Bignier: added 32/64bits separation
  *
- * This file must be used under the terms of the CeCILL.
- * This source file is licensed as described in the file COPYING, which
- * you should have received as part of this distribution.  The terms
- * are also available at
- * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
  *
  -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="test_run" xml:lang="fr">
@@ -35,7 +38,7 @@
                 <term>module</term>
                 <listitem>
                     <para>
-                        Un tableau de chaînes de caractères ou <literal>[]</literal>. Nom des modules ou répertoires à tester, tous les modules internes de scilab si <literal>[]</literal>
+                        Un tableau de chaînes de caractères ou <literal>[]</literal> (ou <literal>"[]"</literal>). Nom des modules ou répertoires à tester, tous les modules internes de scilab si <literal>[]</literal>
                     </para>
                     <itemizedlist>
                         <listitem>
@@ -60,7 +63,7 @@
                 <term>test_name</term>
                 <listitem>
                     <para>
-                        Un tableau de chaînes de caractères ou <literal>[]</literal>. Le nom des tests à exécuter lors de cette passe de tests, tous les tests si <literal>[]</literal>
+                        Un tableau de chaînes de caractères ou <literal>[]</literal> (ou <literal>"[]"</literal>). Le nom des tests à exécuter lors de cette passe de tests, tous les tests si <literal>[]</literal>
                     </para>
                 </listitem>
             </varlistentry>
@@ -68,7 +71,7 @@
                 <term>options</term>
                 <listitem>
                     <para>
-                        Un tableau de chaînes de caractères ou <literal>[]</literal>. Les options à utiliser pour la passe de test, les options par défaut si <literal>[]</literal>
+                        Un tableau de chaînes de caractères ou <literal>[]</literal> (ou <literal>"[]"</literal>). Les options à utiliser pour la passe de test, les options par défaut si <literal>[]</literal>
                     </para>
                     <variablelist>
                         <varlistentry>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
 // Lance tous les tests
+// Cela peut prendre du temps...
 // =============================================
 
-test_run();
-test_run([]);
-test_run([],[]);
+// test_run();
+// test_run([]);
+// test_run([],[]);
+// test_run("[]","[]");
+// test_run [] [];
 
 // Teste un ou plusieurs modules
 // =============================================
@@ -419,7 +425,7 @@ test_run('time',['datenum';'calendar'],'skip_tests');
 test_run('time','datenum','no_check_ref');
 
 // création d'un fichier .dia.ref
-test_run([],[],'create_ref');
+// test_run([],[],'create_ref');
 
 // liste des tests disponibles
 test_run([],[],'list');
@@ -438,6 +444,9 @@ test_run('boolean','bug_2799','no_check_error_output');
 
 // Combinaisons d'options
 test_run([],[],['no_check_ref','mode_nw']);
+
+// Console mode
+test_run time [] no_check_ref //tests time module with no_check_ref option
  ]]></programlisting>
         
         <programlisting role="example"><![CDATA[
@@ -460,6 +469,11 @@ test_run('time','datenum',[],TMPDIR+"/time_datenum_test_run.xml");
             Les scripts de tests ne sont pas exécutés tels qu'écrit, un en-tête et un pied de page spécifiques sont rajoutés à chaque test.
             Le but est d'instrumenter le fichier de tests afin de rediriger les sorties dans un fichier de log spécique au test.
         </para>
+        <para>
+            La durée d'exécution pour chaque test est fixé à 5 minutes. Pour
+            désactiver la terminaison du test après ce délai, utilisez le tag
+            <literal>LONG TIME EXECUTION</literal>.
+        </para>
     </refsection>
     <refsection>
         <title>Historique</title>
@@ -494,7 +508,12 @@ test_run('time','datenum',[],TMPDIR+"/time_datenum_test_run.xml");
             </revision>
             <revision>
                 <revnumber>6.0.0</revnumber>
-                <revdescription>mode profiling ajouté pour permettre l'analyse du profil d'exécution avec valgrind (Linux uniquement)</revdescription>
+                <revdescription>
+                    <para>mode profiling ajouté pour permettre l'analyse du profil d'exécution avec valgrind (Linux uniquement)</para>
+                    <para>
+                        durée d'exécution maximale d'un test sans <literal>LONG TIME EXECUTION</literal> configurée à 5 minutes.
+                    </para>
+                </revdescription>
             </revision>
         </revhistory>
     </refsection>