Update dot help pages
[scilab.git] / scilab / modules / core / help / fr_FR / 1_keywords / dot.xml
index cfd1d55..8097018 100644 (file)
@@ -7,10 +7,15 @@
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
         <synopsis>123.33
+
             a.*b
-            
-            [123,..
-            456]
+            a .*. b
+
+            %pi * (%e + ..
+            %i)
+
+            cd ..
+            dir ..
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                     <para>
                         La fonction <literal>foo</literal> suivante :
                     </para>
-                    <programlisting role=""><![CDATA[ 
-function foo
-  a=1
-  disp(a),..
-  disp('ok')
+                    <programlisting role=""><![CDATA[
+function foo()
+    plot2d()
+    xtitle(["Titre général"; "Peut être sur plusieurs lignes, donc assez long"], ..
+            "Ceci est le titre de l''axe des X", "titre de l''axe Y")
 endfunction
  ]]></programlisting>
                     <para>est équivalente à :</para>
-                    <programlisting role=""><![CDATA[ 
-function foo 
-  a=1
+                    <programlisting role=""><![CDATA[
+function foo()
+    plot2d()
 
-  disp(a),disp('ok') 
+    xtitle(["Titre général"; "Peut être sur plusieurs lignes, donc assez long"], "Ceci est le titre de l''axe des X", "titre de l''axe Y")
 endfunction
  ]]></programlisting>
                     <para>La ligne logique formée par les lignes physiques 3 et 4 est
@@ -80,6 +85,11 @@ endfunction
                         de faire est nécessaire car les points de suite peuvent apparaître
                         n'importe où dans la ligne logique, même à l'intérieur d'une
                         expression.
+                        <note>La différence entre lignes logiques et lignes physiques
+                        a son importance lors de l'édition (scinotes, edit), lors de profilage (profile, 
+                        showprofile, plotprofile), et dans les messages d'erreurs (whereami),
+                        lorsque le numéro de ligne est fourni ou affiché.
+                        </note>
                     </para>
                 </listitem>
             </varlistentry>
@@ -88,10 +98,60 @@ endfunction
     <refsection>
         <title>Exemples</title>
         <programlisting role="example"><![CDATA[ 
+// Point decimal
 1.345
-x=[1 2 3];x.^2 .*x // il faut absolument mettre un espace entre le 2 et le point
-[123,..
- 456]
+x = [1 2 3];
+x.^2 .*x // il faut absolument mettre un espace entre le 2 et le point
+
+// Dans le symbole de certains operateurs
+x = [1 2 3];
+x.^2 .*x  // Attention à l'espace :  2. * x  n'est pas   2 .* x !
+
+// Lorsqu'une matrice est écrite ligne par ligne, ".." peut être utilisé mais n'est pas obligatoire.
+N = [   ..
+    63.    89.    3.   ..
+    91.    56.    22.  ..
+    15.    64.    40.  ..
+    ]
+// Elle peut être plus simplement saisi (ou copié/collé depuis/dans la console ou un script),
+// sans devoir manuellement ajouter ".." à la fin de chaque ligne :
+N = [
+    63.    89.    3.
+    91.    56.    22.
+    15.    64.    40.
+    ]
+
+// Dans les instructions très longues telles que les uicontrol() où l'indication de nombreuses
+//  propriétés est souvent requise, la marque .. de continuation est quasi incontournable. Elle
+//  permet d'écrire une propriété par ligne, ce qui rend le code lisible et compatible avec
+//  les règles de style de code de Scilab :
+fig = figure("figure_name", "FIGURE", ..
+             "dockable",    "off", ..
+             "axes_size",   [990,670], ..
+             "infobar_visible", "off", ..
+             "toolbar",     "none", ..
+             "menubar_visible", "on", ..
+             "menubar",     "none", ..
+             "default_axes","off", ..
+             "layout",      "border", ..
+             "background",  color(244,244,244), ..
+             "tag",         "figure_1", ..
+             "visible",     "on");
+
+// Appels de fonctions orientés console (sans les () ) avec un paramètre ".." :
+d = pwd(); cd SCI/contrib
+cd ..   // équivaut à cd("..") et n'attend rien en ligne suivante
+cd(d)   // (retour à votre dossier initial)
+
+// Cette expression ne fonctionne plus dans Scilab 6
+a = "Je commence à écrire une très longue chaîne de caractères...
+     - et je continue ici"
+// L'expression suivante est celle à utiliser
+a = "Je commence à écrire une très longue chaîne de caractères"+...
+    "    - et je continue ici"
+// Cette expression n'est plus autorisée dans Scilab 6: Les singletons doivent être écrits sur une ligne
+y = 12..
+45
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
@@ -109,6 +169,34 @@ x=[1 2 3];x.^2 .*x // il faut absolument mettre un espace entre le 2 et le point
             <member>
                 <link linkend="backslash">backslash</link>
             </member>
+            <member>
+                <link linkend="whereami">whereami</link>
+            </member>
+            <member>
+                <link linkend="showprofile">showprofile</link>
+            </member>
+            <member>
+                <link linkend="edit">edit</link>
+            </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>Historique</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        Il est désormais impossible de couper un scalaire.
+                    </para>
+                    <para>
+                        Pour couper une chaîne de caractères, les opérateurs "+ .." doivent être utilisés.
+                    </para>
+                    <para>Dans les appels de fonctions en mode orienté console,
+                        <literal>myfun ..</literal> n'attend plus de suite en ligne suivante.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>