Update dot help pages
[scilab.git] / scilab / modules / core / help / ru_RU / 1_keywords / dot.xml
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>