Update of Russian help pages for different functions. 13/11213/1
Stanislav KROTER [Wed, 3 Apr 2013 14:55:46 +0000 (20:55 +0600)]
Change-Id: I1a90b0f86900c652a81660d90614d16029304a5f

24 files changed:
scilab/modules/core/help/ru_RU/debugging/whereami.xml
scilab/modules/core/help/ru_RU/variables/clearglobal.xml
scilab/modules/core/help/ru_RU/variables/isglobal.xml
scilab/modules/core/help/ru_RU/variables/who_user.xml
scilab/modules/core/help/ru_RU/variables/whos.xml
scilab/modules/data_structures/help/ru_RU/getfield.xml
scilab/modules/data_structures/help/ru_RU/rlist.xml
scilab/modules/data_structures/help/ru_RU/tlist.xml
scilab/modules/differential_equations/help/ru_RU/dasrt.xml
scilab/modules/elementary_functions/help/ru_RU/and.xml
scilab/modules/elementary_functions/help/ru_RU/elementarymatrices/logspace.xml
scilab/modules/elementary_functions/help/ru_RU/signalprocessing/bloc2exp.xml
scilab/modules/elementary_functions/help/ru_RU/signalprocessing/bloc2ss.xml
scilab/modules/elementary_functions/help/ru_RU/signalprocessing/trfmod.xml
scilab/modules/fileio/help/ru_RU/fileinfo.xml
scilab/modules/fileio/help/ru_RU/fscanfMat.xml
scilab/modules/fileio/help/ru_RU/mclose.xml
scilab/modules/fileio/help/ru_RU/mdelete.xml
scilab/modules/fileio/help/ru_RU/meof.xml
scilab/modules/fileio/help/ru_RU/mopen.xml
scilab/modules/fileio/help/ru_RU/mputstr.xml
scilab/modules/fileio/help/ru_RU/mtell.xml
scilab/modules/fileio/help/ru_RU/path_filename/basename.xml
scilab/modules/fileio/help/ru_RU/sscanf.xml

index f17f7c3..d3dbb5b 100644 (file)
@@ -11,7 +11,7 @@
     <refsection>
         <title>Описание</title>
         <para>
-            Выводит на экран дерево вызова инструкции, которая содержит <literal>whereami()</literal>. Может быть использована на уровнях в режиме паузы (<literal>pause</literal>).
+            Выводит на экран дерево вызова инструкции, которая содержит <code>whereami()</code>. Может быть использована на уровнях в режиме паузы (<function>pause</function>).
         </para>
     </refsection>
     <refsection>
index d9bf7ca..2406793 100644 (file)
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>clearglobal()</literal> уничтожает все глобальные переменные.
+            <code>clearglobal()</code> уничтожает все глобальные переменные.
         </para>
         <para>
-            <literal>clearglobal nam1 ... namn</literal> уничтожает глобальные переменные, перечисленные 
-            по именам.
+            <literal>clearglobal nam1 ... namn</literal> уничтожает 
+            глобальные переменные, перечисленные по именам.
         </para>
         <para>
-            Обратите внимание, что <literal>clearglobal()</literal> уничтожает только глобальные переменные, но локальные копии этих глобальных переменных не уничтожаются.
+            <note>
+                Обратите внимание, что <code>clearglobal()</code> 
+                уничтожает только глобальные переменные, но локальные 
+                копии этих глобальных переменных не уничтожаются.
+            </note>
         </para>
     </refsection>
     <refsection>
index 3f9d2f9..d1165a7 100644 (file)
@@ -2,11 +2,13 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="isglobal">
     <refnamediv>
         <refname>isglobal</refname>
-        <refpurpose>проверка, является ли переменная глобальной</refpurpose>
+        <refpurpose>
+            проверка, является ли переменная глобальной
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>t=isglobal(x)</synopsis>
+        <synopsis>t = isglobal(x)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
             <varlistentry>
                 <term>x</term>
                 <listitem>
-                    <para>любая переменная</para>
+                    <para>любая переменная.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>t</term>
                 <listitem>
-                    <para>логическое значение</para>
+                    <para>логическое значение.</para>
                 </listitem>
             </varlistentry>
         </variablelist>
@@ -28,7 +30,7 @@
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>isglobal(x)</literal> возвращает <emphasis>истину</emphasis>, если <literal>x</literal>
+            <code>isglobal(x)</code> возвращает <emphasis>истину</emphasis>, если <varname>x</varname>
             была объявлена глобальной переменной, и <emphasis>ложь</emphasis> в противном случае.
         </para>
     </refsection>
index 6500199..551f757 100644 (file)
@@ -9,9 +9,38 @@
         <synopsis>who_user()</synopsis>
     </refsynopsisdiv>
     <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>bPrint</term>
+                <listitem>
+                    <para>
+                        включает или отключает вывод на экран (по умолчанию: <constant>%t</constant>).
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Возвращаемое значение</title>
+        <variablelist>
+            <varlistentry>
+                <term>varList</term>
+                <listitem>
+                    <para>
+                        вектор-столбец пользовательских переменных, либо 
+                        <listing>[]</listing>, если у пользователя нет 
+                        переменных.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
         <title>Описание</title>
         <para>
-            <literal>who_user</literal> выводит на экран имена пользовательских переменных.
+            <function>who_user</function> выводит на экран и/или 
+            возвращает имена пользовательских переменных.
         </para>
     </refsection>
     <refsection role="see also">
             </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>
+                    <function>who_user</function> can now return user's variable names in a column vector of character strings.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 03c6712..0fad960 100644 (file)
@@ -27,7 +27,7 @@
                 <term>nam</term>
                 <listitem>
                     <para>
-                        имена переменных, первые символы которых <literal>nam</literal>
+                        первые символы выбранных имён.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>whos()</literal> выводит на экран все имена текущих переменных, сортированных по имени (регистр не имеет значения), типы и используемую память.
+            <code>whos()</code> выводит на экран все имена текущих 
+            переменных, сортированных по имени (регистр не имеет 
+            значения), типы и используемую память.
         </para>
         <para>
-            <literal>whos -type typ</literal> выводит на экран все текущие переменные определённого типа <literal>typ</literal>.
+            <literal>whos -type typ</literal> выводит на экран все 
+            текущие переменные определённого типа <varname>typ</varname>.
         </para>
         <para>
-            <literal>whos -name nam</literal> выводит на экран имена переменных, которые начинаются с <literal>nam</literal>.
+            <literal>whos -name nam</literal> выводит на экран имена 
+            переменных, которые начинаются с <varname>nam</varname>.
         </para>
         <para>
-            Обратите внимание: если переменная является глобальной, то после названия типа этой переменной появляется символ <literal>*</literal>.
+            <note>
+                Обратите внимание: если переменная является глобальной, то после названия типа этой переменной появляется символ <literal>*</literal>.
+            </note>
         </para>
     </refsection>
     <refsection>
index 99853d4..1a52bb2 100644 (file)
@@ -17,7 +17,7 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>[x,...] = getfield(i, lst)</synopsis>
+        <synopsis>[x,...] = getfield(i, l)</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Аргументы</title>
@@ -29,7 +29,7 @@
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>lst</term>
+                <term>l</term>
                 <listitem>
                     <para>
                         список (list), типизированный список (tlist) или матричноориентированный список (mlist).
@@ -49,7 +49,7 @@
     <refsection>
         <title>Описание</title>
         <para>
-            Инструкция <literal>[x,...] = getfield(i, lst)</literal> эквивалентна  <literal>[x,...] = lst(i)</literal> для выделения поля с той лишь разницей, что она может также применяться к объектам типа <literal>mlist</literal>.
+            Инструкция <literal>[x,...] = getfield(i, l)</literal> эквивалентна  <literal>[x,...] = l(i)</literal> для выделения поля с той лишь разницей, что она может также применяться к объектам типа <literal>mlist</literal>.
         </para>
     </refsection>
     <refsection>
index d99bd57..410c49b 100644 (file)
@@ -13,7 +13,9 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="rlist">
     <refnamediv>
         <refname>rlist</refname>
-        <refpurpose>определение функции рационального деления Scilab rational fraction function definition</refpurpose>
+        <refpurpose>
+            определение функции рационального деления Scilab
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
     <refsection>
         <title>Описание</title>
         <para>
-            <literal>rlist(a1, ..., an)</literal> is a shortcut  to
+            <literal>rlist(a1, ..., an)</literal> - сокращённая запись для
             <literal>tlist(['r','num';'den','dt'], a1, ..., an)</literal>.
         </para>
         <para>
             <literal>rlist(a1, ..., an)</literal> создаёт <literal>tlist</literal> с  <literal>['r','num';'den','dt']</literal> в качестве первого элемента и <literal>ai</literal>-тыми в качестве последующих элементов, если они есть. Над <literal>ai</literal>-тыми элементами не делается проверка ни типа ни размера.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+s=poly(0,'s');
+W=[1/s,1/(s+1)]
+W'*W
+Num=[s,s+2;1,s];
+Den=[s*s,s;s,s*s];
+rlist(Num,Den,[])
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
@@ -40,6 +53,9 @@
             <member>
                 <link linkend="syslin">syslin</link>
             </member>
+            <member>
+                <link linkend="rational">rational</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index db27971..05cfaec 100644 (file)
@@ -50,7 +50,7 @@
             <code>typ(1)</code> определяет тип списка (символьная строка, используемая для определения запрограммированных действий).
         </para>
         <para>
-            Если определено это, то <code>typ(i)</code> может дать <literal>(i+1)</literal>-тому элементу формальное имя.
+            Если это определено, то <code>typ(i)</code> может дать <literal>(i+1)</literal>-тому элементу формальное имя.
         </para>
         <para>
             Стандартные операции, определённые над списками <literal>list</literal> работают и типизированными списками <literal>tlist</literal>:
index 96ca38a..9e88bf4 100644 (file)
@@ -73,8 +73,8 @@
                 <listitem>
                     <para>
                         вектор с двумя элементами <literal>[times num]</literal>, где
-                        <literal>times</literal> -- значение момента времени, когда поверхность пересекается,
-                        <literal>num</literal> -- номер пересечённой поверхности.
+                        <literal>times</literal> - значение момента времени, когда поверхность пересекается,
+                        <literal>num</literal> - номер пересечённой поверхности.
                     </para>
                 </listitem>
             </varlistentry>
@@ -131,8 +131,10 @@ r=res(t,y,ydot,x1,x2,...)
                                 <literal>(t,y,ydot,x1,x2,...)</literal>.
                             </para>
                             <para>
-                                Внимание:
-                                эта форма не должна использоваться, если нет дополнительного аргумента для передачи в функцию.
+                                <warning>
+                                    Внимание:
+                                    эта форма не должна использоваться, если нет дополнительного аргумента для передачи в функцию.
+                                </warning>
                             </para>
                         </listitem>
                         <listitem>
@@ -175,7 +177,7 @@ integer ires,ipar(*)
                                 <literal>r=jac(t,y,ydot,cj)</literal> и
                                 <literal>jac</literal> должна возвращать 
                                 <literal>r=dg(t,y,ydot)/dy+cj*dg(t,y,ydot)/dydot</literal>, где
-                                <literal>cj</literal> -- вещественный скаляр.
+                                <literal>cj</literal> - вещественный скаляр.
                             </para>
                         </listitem>
                         <listitem>
@@ -357,7 +359,7 @@ integer ny,ng
                 <listitem>
                     <para>
                         вещественная матрица. Каждый столбец является вектором <literal>[t;x(t);xdot(t)]</literal>,
-                        где <literal>t</literal> -- индекс времени для которого требуется найти решение.
+                        где <literal>t</literal> - индекс времени для которого требуется найти решение.
                     </para>
                 </listitem>
             </varlistentry>
index b1db266..8215afd 100644 (file)
             <literal>y(i)= and(A(i,j),j=1,n)</literal>)).
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+A = [];
+and(A)
+
+A = %T(ones(1, 3));
+and(A)
+
+A = %F(ones(1, 3));
+and(A)
+
+A = %T(ones(1, 3));
+and(A, '*')
+and(A, 'c')
+and(A, 2)
+and(A, 'r')
+and(A, 1)
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 729a9f2..6b46fd7 100644 (file)
@@ -43,7 +43,7 @@
     <refsection>
         <title>Описание</title>
         <para>
-            Возвращает вектор-строку из <literal>n</literal> точек равномерно распределённых в логарифмическом масштабе между <latex>10^{d1}</latex> и <latex>10^{d2}</latex>. Если <literal>d2=%pi</literal>, то точки располагаются между <latex>10^{d1}</latex> и <latex>\pi</latex>.
+            Возвращает вектор-строку из <literal>n</literal> точек равномерно распределённых в логарифмическом масштабе между <latex>10^{d1}</latex> и <latex>10^{d2}</latex>. Если <latex>d2=\pi</latex>, то точки располагаются между <latex>10^{d1}</latex> и <latex>\pi</latex>.
         </para>
     </refsection>
     <refsection>
index 8be5219..b38dc08 100644 (file)
@@ -106,6 +106,9 @@ list('link','name_of_link',
             связывает (выходной) порт 1 <literal>S2</literal> с выходом (порт 0 условного блока 
             -1 не рассматривается) и с (входным) портом 2 сумматора.
         </para>
+    </refsection>
+    <refsection>
+        <title>Examples</title>
         <programlisting role="example"><![CDATA[ 
 //Инициализация
 syst=list('blocd'); l=1;
index 870acc1..c635b62 100644 (file)
@@ -90,6 +90,9 @@ list('link','name_of_link',
             связывает (выходной) порт 1 <literal>S2</literal> с выходом (порт 0 условного блока 
             -1 не рассматривается) и с (входным) портом 2 сумматора.
         </para>
+    </refsection>
+    <refsection>
+        <title>Examples</title>
         <programlisting role="example"><![CDATA[ 
 //Инициализация
 syst=list('blocd'); l=1;
index 6b0701d..4fdb229 100644 (file)
             Интерактивное упрощение <literal>h</literal>. <literal>trfmod</literal> открывает окно диалога.
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+// с передаточной функцией
+s=poly(0,'s');
+gs=syslin('c',1/(s+1));
+trfmod(gs)
+
+// с матрицей пространства состояний
+A=diag([1,2,3]);
+B=[1;1;1];
+C=[2,2,2];
+sys=syslin('c',A,B,C);
+trfmod(sys)
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index d32bb4f..bd3c16f 100644 (file)
             Числовой режим представляет собой от одной до четырёх восьмеричных цифр
             (0-7), полученных добавлением битов со значениями 4, 2 и
             1. Любые опущенные цифры предполагаются предварёнными
-            нулями. Первая цифра выбирает набор аттрибутов идентификатора пользователя
+            нулями. Первая цифра выбирает набор атрибутов идентификатора пользователя
             (4), группы пользователя (2) и sticky-бита (1). Вторая цифра
             выбирает права пользователя, который владеет файлом: чтение (4),
             запись (2) и исполнение (1); третье число выбирает права для
             других пользователей в группе файлов с теми же самыми значениями.
         </para>
+        <para>
+            So, to check permissions, it is necessary to use masks. Let us take an example:
+            In octal, x(2)=1664, so first digit corresponds to sticky attributes. The second
+            indicates that file owner has permission of writing and reading. It is the same
+            for other users in the file's group. Finally, others users has just right to read.
+            To apply a mask, it is simpler to look at this octal in binary. 
+            So: <varname>x</varname>(2)= 1 110 110 100.
+            To check if the owner has write permission, we must take a look at the second triplet: 110 
+            and compare it with write permission 010. So, the operation is: 110 000 000 &amp; 010 000 000.
+            If result is not null (it is the case here), owner has write permission.
+        </para>
     </refsection>
     <refsection>
         <title>Примеры</title>
index fd1b77a..d1bba61 100644 (file)
         <para>
             <function>fscanfMat</function> поддерживает файлы с кодировкой ANSI/ASCII и UTF-8.
         </para>
+        <para>
+            Для чтения CSV-файлов, рекомендуется функция <link linkend="csvRead">csvRead</link>.
+        </para>
     </refsection>
     <refsection>
         <title>Примеры</title>
index a17df9c..3c105a7 100644 (file)
@@ -47,7 +47,7 @@
     <refsection>
         <title>Описание</title>
         <para>
-            <function>mclose</function> должен использоваться для закрытия файла, открытого функцией <function>mopen</function>. Если <varname>fd</varname> опущен, то <function>mclose</function> закрывает последний открытый файл.
+            Функция <function>mclose</function> должна использоваться для закрытия файла, открытого функцией <function>mopen</function>. Если <varname>fd</varname> опущен, то <function>mclose</function> закрывает последний открытый файл.
         </para>
         <para>
             <code>mclose('all')</code> закрывает все файлы, открытые с помощью
             </caution>
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+fd = mopen(TMPDIR + filesep() + 'mclose_tst','wt');
+mclose(TMPDIR + filesep() + 'mclose_tst');
+
+fd=mopen('SCI/etc/scilab.start','r')
+mgetl(fd,10)
+mclose(fd)
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 837aa53..70bce67 100644 (file)
             </caution>
         </para>
     </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+r = mputl('Эта строчка просто для образца.', TMPDIR+'/dummyFile.dummy');
+mdelete(TMPDIR+"/dummyFile.dummy");
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 18ab222..528eba4 100644 (file)
             используется для сброса флага ошибки и флага конца файла в ноль.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+
+// Запись временного файла с неким текстом внутри него
+this_file = pathconvert(TMPDIR+"/mputstr.txt", %F);
+
+fd = mopen(this_file, "wt");
+mputstr("Scilab is a numerical computing software.", fd);
+mclose(fd);
+
+fd = mopen(this_file,'rt');
+i = 0;
+while ~meof(fd) do
+   mfscanf(1, fd, "%c");
+   i = i + 1;
+end
+
+mclose(fd);
+
+disp("Scilab has found " + string(i) + " chars in the file");
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index c2ee487..f9cc2d8 100644 (file)
@@ -43,7 +43,7 @@
                         указания бинарного файла.
                     </para>
                     <para>
-                        Значение по умолчанию -- <literal>'rb'</literal>.
+                        Значение по умолчанию - <literal>'rb'</literal>.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
     </refsection>
     <refsection>
+        <title>Примеры</title>
         <programlisting role="example"><![CDATA[
 // открываем SCI+'/ACKNOWLEDGEMENTS' как текст только для чтения
 fd_r = mopen(SCI+'/ACKNOWLEDGEMENTS', 'rt')
index bab0cb3..be8fb7b 100644 (file)
             Функция <function>mputstr</function> позволяет записать символьную строку <varname>str</varname> в двоичный файл.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+
+this_file = pathconvert(TMPDIR+"/mputstr.txt", %F);
+
+fd = mopen(this_file, "wt");
+mputstr("Scilab", fd);
+mclose(fd);
+
+mgetl(this_file) // Scilab
+
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index ec08488..f9cf039 100644 (file)
@@ -14,7 +14,7 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="mtell">
     <refnamediv>
         <refname>mtell</refname>
-        <refpurpose>управление двоичными файлами</refpurpose>
+        <refpurpose>возвращает смещение текущего байта относительно начала файла</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
             Функция <function>mtell</function> возвращает смещение текущего байта относительно начала файла, связанного с именованным потоком <varname>fd</varname>.
         </para>
     </refsection>
+    <refsection>
+        <title>Examples</title>
+        <programlisting role="example"><![CDATA[
+// Откроем запись временного двоичного файла
+testFile=TMPDIR + '/testFile.bin';
+fd = mopen(testFile,'wb');
+
+mput(42,'d'); // Запишем 42 в последний открытый файл
+mtell() // Вернёт 8, текущее положение в дескрипторе файла
+
+mput(42+2,'d', fd); // Откроем непосредственно fd, чтобы записать 42
+mtell(fd) // Вернёт 16, текущее положение в дескрипторе файла
+
+mseek(0, fd); // возврат в начало файла
+mtell(fd) // Вернёт 0
+
+mclose(fd);
+ ]]></programlisting>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
index 4b273eb..ce0affe 100644 (file)
@@ -12,9 +12,6 @@
  *
  -->
 <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="basename" xml:lang="ru">
-    <info>
-        <pubdate>$LastChangedDate$</pubdate>
-    </info>
     <refnamediv>
         <refname>basename</refname>
         <refpurpose>отсекает директорию и расширение от имён файлов</refpurpose>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>flag, flagexpand</term>
+                <term>flag</term>
                 <listitem>
                     <para>
-                        логические необязательные параметры. Значение по умолчанию <constant>%t</constant>.
+                        логический необязательный параметр, используемые 
+                        для преобразования указанных путей в текущей 
+                        операционной системе. Значение по умолчанию 
+                        "истина" (<constant>%t</constant>).
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>flagexpand</term>
+                <listitem>
+                    <para>
+                        логический необязательный параметр, используемый 
+                        для расширения переменных, идущих впереди, в 
+                        пути. Используется только с аргументом 
+                        <varname>flag</varname> argument. Значение по 
+                        умолчанию "истина" (<constant>%t</constant>).
                     </para>
                 </listitem>
             </varlistentry>
index 2d7d56c..80df8b5 100644 (file)
         <title>Описание</title>
         <para>
             <caution>
-                Эта функция устарела, лучше использовать функцию
-                <function>msscanf</function>, которая более эффективна и более 
-                совместима с C-функцией <function>sscanf</function>.
-            </caution>
+                Эта функция устарела и будет удалена в Scilab 5.5.0, 
+                лучше использовать функцию <function>msscanf</function>, 
+                которая более эффективна и более совместима с C-функцией 
+                <function>sscanf</function>.
+             </caution>
+             </caution>
         </para>
         <para>
             Функция <function>sscanf</function> интерпретирует символьную 
             </listitem>
         </itemizedlist>
     </refsection>
+    <refsection>
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.1</revnumber>
+                <revremark>
+                    Функция помечена как устаревшая. Будет удалена в 5.5.0.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">