Update dot help pages 61/16961/7
Charlotte HECQUET [Wed, 29 Jul 2015 13:59:46 +0000 (15:59 +0200)]
Change-Id: I93bc3657d743671e1498cda7c6e350f8ce8803af

scilab/modules/core/help/en_US/1_keywords/dot.xml
scilab/modules/core/help/fr_FR/1_keywords/dot.xml
scilab/modules/core/help/ja_JP/1_keywords/dot.xml
scilab/modules/core/help/pt_BR/1_keywords/dot.xml
scilab/modules/core/help/ru_RU/1_keywords/dot.xml

index 9c0f222..a5f13e9 100644 (file)
@@ -8,10 +8,15 @@
         <title>Calling Sequence</title>
         <synopsis>
             123.33
+
             a.*b
-            
-            [123,..
-            456]
+            a .*. b
+
+            %pi * (%e + ..
+            %i)
+
+            cd ..
+            dir ..
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                     <para>
                         The following function <literal>foo</literal>:
                     </para>
-                    <programlisting role=""><![CDATA[ 
-function foo
-  a=1
-  disp(a),..
-  disp('ok')
+                    <programlisting role=""><![CDATA[
+function foo()
+    plot2d()
+    xtitle(["General title"; "It can be multiline, so quite long"], ..
+            "This is the X-axis title", "Y title")
 endfunction
  ]]></programlisting>
                     <para>is equivalent to:</para>
-                    <programlisting role=""><![CDATA[ 
-function foo 
-  a=1
+                    <programlisting role=""><![CDATA[
+function foo()
+    plot2d()
 
-  disp(a),disp('ok') 
+    xtitle(["General title"; "It can be multiline, so quite long"], "This is the X-axis title", "Y title")
 endfunction
  ]]></programlisting>
                     <para>The logical line formed by physical line 3 and physical line 4
@@ -78,6 +83,22 @@ endfunction
                         physical line 3 would be empty. This is done this way because
                         continuation marks can be put anywhere even inside an
                         expression.
+                        <note>The difference between logical and physical
+                        lines is of importance when dealing with edition (scinotes, edit), with
+                        profiling (profile, showprofile, plotprofile), and within error messages
+                        (whereami), when the line number is provided or displayed.
+                        </note>
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>".." parameter</term>
+                <listitem>
+                    <para>When functions are used in a console-oriented way, <literal>..</literal>
+                        is not considered as a continuation mark but as a simple argument. The most
+                        common usage is with <literal>cd ..</literal>, <literal>dir ..</literal>
+                        or <literal>ls ..</literal> actually standing for <literal>cd("..")</literal>,
+                        etc.
                     </para>
                 </listitem>
             </varlistentry>
@@ -90,15 +111,50 @@ endfunction
 1.345
 
 //used as part of an operator
-x=[1 2 3];x.^2 .*x // a space is required between 2 and dot
+x = [1 2 3];x.^2 .*x // a space is required between 2 and dot
 
-// used to enter continuation lines
-T=[123,..//first element
-   456] //second one
+// When writing rows of a matrix on different lines, ".." can be used but are not mandatory.
+N = [   ..
+    63.    89.    3.   ..
+    91.    56.    22.  ..
+    15.    64.    40.  ..
+    ]
+// It can be more simply entered as (or copied/pasted from/to console or script), without appending ".."
+N = [
+    63.    89.    3.
+    91.    56.    22.
+    15.    64.    40.
+    ]
 
-a="here I start a very long string...  //but I'm not in the mood of continuing
+// Within very long instructions like when creating uicontrol where many properties must be set,
+// continuation marks are almost mandatory and allow to write and set one property per line
+// in a readable way. A single huge line would not comply with Scilab coding style:
+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");
+
+// Console-oriented calls with some ".." argument
+d = pwd(); cd SCI/contrib
+cd ..   // stands for cd("..") and expects nothing on the next line
+cd(d)   // Go back to your working directory
+
+// This expression does not work anymore in Scilab 6
+a = "here I start a very long string...  //but I'm not in the mood of continuing
      - and here I go on"
-y=12..
+// This one is the correct expression now
+a = "here I start a very long string"+...  //but I'm not in the mood of continuing
+    "    - and here I go on"
+// This expression is not allowed anymore in Scilab 6: scalar number must be written on one line
+y = 12..
 45
  ]]></programlisting>
     </refsection>
@@ -117,6 +173,34 @@ y=12..
             <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>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        It is not possible anymore to cut a scalar number.
+                    </para>
+                    <para>
+                        To cut a single string, "+.." operators must be used.
+                    </para>
+                    <para>In console-oriented calls, <literal>myfun ..</literal> no longer expects
+                        a continuation on the next line.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
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>
index 6c1281a..fcf5624 100644 (file)
@@ -6,10 +6,17 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>123.33
+        <synopsis>
+            123.33
+
             a.*b
-            [123,..
-            456]
+            a .*. b
+
+            %pi * (%e + ..
+            %i)
+
+            cd ..
+            dir ..
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                     </para>
                     <para>以下の関数 foo:</para>
                     <programlisting role=""><![CDATA[ 
-function foo
-  a=1
-  disp(a),..
-  disp('ok')
+function foo()
+    plot2d()
+    xtitle(["General title"; "It can be multiline, so quite long"], ..
+            "This is the X-axis title", "Y title")
 endfunction
  ]]></programlisting>
                     <para>は次の関数と等価です:</para>
                     <programlisting role=""><![CDATA[ 
-function foo 
-  a=1
+function foo()
+    plot2d()
 
-  disp(a),disp('ok') 
+    xtitle(["General title"; "It can be multiline, so quite long"], "This is the X-axis title", "Y title")
 endfunction
  ]]></programlisting>
                     <para>物理行3行目と物理行4行目からなる論理行は
                         物理行4行目に全体が書かれ,物理行3行目が空の時と
                         同じとなります.このようなことが可能なのは,
                         継続記号を式の中の任意の場所に置く事ができるためです.
+                        <note>The difference between logical and physical
+                        lines is of importance when dealing with edition (scinotes, edit), with
+                        profiling (profile, showprofile, plotprofile), and within error messages
+                        (whereami), when the line number is provided or displayed.
+                        </note>
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>".." parameter</term>
+                <listitem>
+                    <para>When functions are used in a console-oriented way, <literal>..</literal>
+                        is not considered as a continuation mark but as a simple argument. The most
+                        common usage is with <literal>cd ..</literal>, <literal>dir ..</literal>
+                        or <literal>ls ..</literal> actually standing for <literal>cd("..")</literal>,
+                        etc.
                     </para>
                 </listitem>
             </varlistentry>
@@ -89,15 +112,50 @@ endfunction
 1.345
 
 //used as part of an operator
-x=[1 2 3];x.^2 .*x // a space is required between 2 and dot
+x = [1 2 3];x.^2 .*x // a space is required between 2 and dot
+
+// When writing rows of a matrix on different lines, ".." can be used but are not mandatory.
+N = [   ..
+    63.    89.    3.   ..
+    91.    56.    22.  ..
+    15.    64.    40.  ..
+    ]
+// It can be more simply entered as (or copied/pasted from/to console or script), without appending ".."
+N = [
+    63.    89.    3.
+    91.    56.    22.
+    15.    64.    40.
+    ]
 
-// used to enter continuation lines
-T=[123,..//first element
-   456] //second one
+// Within very long instructions like when creating uicontrol where many properties must be set,
+// continuation marks are almost mandatory and allow to write and set one property per line
+// in a readable way. A single huge line would not comply with Scilab coding style:
+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");
 
-a="here I start a very long string...  //but I'm not in the mood of continuing
+// Console-oriented calls with some ".." argument
+d = pwd(); cd SCI/contrib
+cd ..   // stands for cd("..") and expects nothing on the next line
+cd(d)   // Go back to your working directory
+
+// This expression does not work anymore in Scilab 6
+a = "here I start a very long string...  //but I'm not in the mood of continuing
      - and here I go on"
-y=12..
+// This one is the correct expression now
+a = "here I start a very long string"+...  //but I'm not in the mood of continuing
+    "    - and here I go on"
+// This expression is not allowed anymore in Scilab 6: scalar number must be written on one line
+y = 12..
 45
  ]]></programlisting>
     </refsection>
@@ -116,6 +174,34 @@ y=12..
             <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>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        It is not possible anymore to cut a scalar number.
+                    </para>
+                    <para>
+                        To cut a single string, "+.." operators must be used.
+                    </para>
+                    <para>In console-oriented calls, <literal>myfun ..</literal> no longer expects
+                        a continuation on the next line.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 21446cb..33dfe8b 100644 (file)
@@ -6,10 +6,17 @@
     </refnamediv>
     <refsynopsisdiv>
         <title> Seqüência de Chamamento </title>
-        <synopsis>123.33
+        <synopsis>
+            123.33
+
             a.*b
-            [123,..
-            456]
+            a .*. b
+
+            %pi * (%e + ..
+            %i)
+
+            cd ..
+            dir ..
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                         continuação. Então, marcas de continuação podem ser usadas para
                         cortar uma linha em qualquer ponto.
                     </para>
+                    <para>
+                        The following function <literal>foo</literal>:
+                    </para>
+                    <programlisting role=""><![CDATA[
+function foo()
+    plot2d()
+    xtitle(["General title"; "It can be multiline, so quite long"], ..
+            "This is the X-axis title", "Y title")
+endfunction
+ ]]></programlisting>
+                    <para>is equivalent to:</para>
+                    <programlisting role=""><![CDATA[
+function foo()
+    plot2d()
+
+    xtitle(["General title"; "It can be multiline, so quite long"], "This is the X-axis title", "Y title")
+endfunction
+ ]]></programlisting>
+                    <para>The logical line formed by physical line 3 and physical line 4
+                        is built as if it was entirely written in the physical line 4 while
+                        physical line 3 would be empty. This is done this way because
+                        continuation marks can be put anywhere even inside an
+                        expression.
+                        <note>The difference between logical and physical
+                        lines is of importance when dealing with edition (scinotes, edit), with
+                        profiling (profile, showprofile, plotprofile), and within error messages
+                        (whereami), when the line number is provided or displayed.
+                        </note>
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>".." parameter</term>
+                <listitem>
+                    <para>When functions are used in a console-oriented way, <literal>..</literal>
+                        is not considered as a continuation mark but as a simple argument. The most
+                        common usage is with <literal>cd ..</literal>, <literal>dir ..</literal>
+                        or <literal>ls ..</literal> actually standing for <literal>cd("..")</literal>,
+                        etc.
+                    </para>
                 </listitem>
             </varlistentry>
         </variablelist>
 //usado como parte de um operador
 x=[1 2 3];x.^2 .*x // um espaço é requerido entre 2 e o ponto
 
-// usado como marcas de continuação
-T=[123,..//primeiro elemento
-   456] //segundo elemento
+// When writing rows of a matrix on different lines, ".." can be used but are not mandatory.
+N = [   ..
+    63.    89.    3.   ..
+    91.    56.    22.  ..
+    15.    64.    40.  ..
+    ]
+// It can be more simply entered as (or copied/pasted from/to console or script), without appending ".."
+N = [
+    63.    89.    3.
+    91.    56.    22.
+    15.    64.    40.
+    ]
 
-a=  "aqui, eu começo um  grande string... //mas não quero continuar aqui
-     - e aqui eu continuo."
-y=12..
+// Within very long instructions like when creating uicontrol where many properties must be set,
+// continuation marks are almost mandatory and allow to write and set one property per line
+// in a readable way. A single huge line would not comply with Scilab coding style:
+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");
+
+// Console-oriented calls with some ".." argument
+d = pwd(); cd SCI/contrib
+cd ..   // stands for cd("..") and expects nothing on the next line
+cd(d)   // Go back to your working directory
+
+// This expression does not work anymore in Scilab 6
+a = "here I start a very long string...  //but I'm not in the mood of continuing
+     - and here I go on"
+// This one is the correct expression now
+a = "here I start a very long string"+...  //but I'm not in the mood of continuing
+    "    - and here I go on"
+// This expression is not allowed anymore in Scilab 6: scalar number must be written on one line
+y = 12..
 45
  ]]></programlisting>
     </refsection>
@@ -86,6 +168,34 @@ y=12..
             <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>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        It is not possible anymore to cut a scalar number.
+                    </para>
+                    <para>
+                        To cut a single string, "+.." operators must be used.
+                    </para>
+                    <para>In console-oriented calls, <literal>myfun ..</literal> no longer expects
+                        a continuation on the next line.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 13d3e19..3c8168e 100644 (file)
@@ -8,10 +8,15 @@
         <title>Последовательность вызова</title>
         <synopsis>
             123.33
+
             a.*b
-            
-            [123,..
-            456]
+            a .*. b
+
+            %pi * (%e + ..
+            %i)
+
+            cd ..
+            dir ..
         </synopsis>
     </refsynopsisdiv>
     <refsection>
                         Следующая функция <literal>foo</literal>:
                     </para>
                     <programlisting role=""><![CDATA[ 
-function foo
-  a=1
-  disp(a),..
-  disp('ok')
+function foo()
+    plot2d()
+    xtitle(["Общий заголовок"; "Он может быть многострочным и достаточно длинным"], ..
+            "Это название оси X", "Название оси Y")
 endfunction
  ]]></programlisting>
                     <para>эквивалентна:</para>
                     <programlisting role=""><![CDATA[ 
-function foo 
-  a=1
-  disp(a),disp('ok') 
+function foo()
+    plot2d()
+
+    xtitle(["Общий заголовок"; "Он может быть многострочным и достаточно длинным"],  "Это название оси X", "Название оси Y")
 endfunction
  ]]></programlisting>
                     <para>
@@ -79,10 +84,22 @@ endfunction
                         построена так, как если бы она была полностью написана на физической строке №4, а 
                         физическая строка №3 была бы пустой. Так сделано для того, чтобы обозначения 
                         конкатенации можно было помещать куда угодно внутри выражения.
+                        <note>
+                            Разница между логическими и физическими строками важна, когда идёт редактирование (scinotes, edit) профилирование (<function>profile</function>, <function>showprofile</function>, <function>plotprofile</function>) и в сообщениях об ошибках (<function>whereami</function>), когда номер строки указывается или отображается.
+                        </note>
                     </para>
                 </listitem>
             </varlistentry>
-        </variablelist>
+            <varlistentry>
+                <term>параметр ".."</term>
+                <listitem>
+                    <para>
+                        Когда функции используются способом, ориентированным на рабочее окно, <literal>..</literal> рассматривается не как знак продолжения, а как обычный аргумент. Наиболее общее использование - это <literal>cd ..</literal>, <literal>dir ..</literal>
+                        или <literal>ls ..</literal> вместо <literal>cd("..")</literal> и т. д.
+                    </para>
+                </listitem>
+                </varlistentry>
+            </variablelist>
     </refsection>
     <refsection>
         <title>Примеры</title>
@@ -93,13 +110,50 @@ endfunction
 //используется как часть оператора
 x=[1 2 3];x.^2 .*x // требуется пробел между 2 и точкой
  
-// используется для введения строк продолжения
-T=[123,..//первый элемент
-   456] //второй элемент
-a="здесь я начинаю очень длинную строчку...  //но мне что-то не хочется продолжать
-     - а вот тут я продолжаю"
-y=12..
+// При записи строк матрицы на разных строчках ".." можно использовать, но не обязательно
+N = [   ..
+    63.    89.    3.   ..
+    91.    56.    22.  ..
+    15.    64.    40.  ..
+    ]
+// Можно просто вставлять (или копировать/вставлять из/в рабоче окно или сценарий),
+// без добавления ".." вручную в конце строки
+N = [
+    63.    89.    3.
+    91.    56.    22.
+    15.    64.    40.
+    ]
+
+// Внутри очень длинных инструкций, таких как создание объекта пользовательского интерфейса, где необходимо
+// установить много свойств,знаки продолжения являются почти обязательными и позволяют писать и устанавливать
+// одно свойство на строчку в удобочитаемом виде. Одиночная огромная строчка может не соответствовать
+// стилю написания кода в 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");
+
+// Вызовы, ориентированные на рабочее окно с аргументом ".."
+d = pwd(); cd SCI/contrib
+cd ..   // заменяет cd("..") и ничего не ожидает на следующей строчке
+cd(d)   // переход назад в вашу рабочую директорию
+
+// Это выражение больше не будет работать в Scilab 6
+a = "здесь я начинаю очень длинную строку...  //но не в настроении продолжать
+     - а здесь продолжаю"
+// Теперь эта строка является корректным выражением
+a = "здесь я начинаю очень длинную строку"+...  //но не в настроении продолжать
+"    - а здесь продолжаю"
+// Это выражение в Scilab 6 более не разрешено: скалярное число должно быть написано в одной строчке
+y = 12..
 45
  ]]></programlisting>
     </refsection>
@@ -118,6 +172,34 @@ y=12..
             <member>
                 <link linkend="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>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revremark>
+                    <para>
+                        Больше нельзя разрезать скалярные числа.
+                    </para>
+                    <para>
+                        Чтобы разрезать одиночную строку, необходимо использовать операторы "+..".
+                    </para>
+                    <para>
+                        В вызовах, ориентированных на рабочее окно, <literal>myfun ..</literal> больше не ожидает продолжения на следующей строчке.
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>