From bf7e926ca93b73a711b742990d2e020f85f423ab Mon Sep 17 00:00:00 2001
From: Stanislav KROTER <krotersv@gmail.com>
Date: Sun, 1 Dec 2013 13:50:48 +0600
Subject: [PATCH] Revision of help page for listfunctions function

Added russian translation of this help page.

Change-Id: I5000fabd5d49adb112ec341f5ecc455f71110ea7
---
 .../modules/functions/help/en_US/listfunctions.xml |   35 ++++--
 .../modules/functions/help/ja_JP/listfunctions.xml |   29 +++--
 .../modules/functions/help/pt_BR/listfunctions.xml |   24 ++--
 .../modules/functions/help/ru_RU/listfunctions.xml |  132 ++++++++++++++++++++
 4 files changed, 189 insertions(+), 31 deletions(-)
 create mode 100644 scilab/modules/functions/help/ru_RU/listfunctions.xml

diff --git a/scilab/modules/functions/help/en_US/listfunctions.xml b/scilab/modules/functions/help/en_US/listfunctions.xml
index bb6515d..0e6c87d 100644
--- a/scilab/modules/functions/help/en_US/listfunctions.xml
+++ b/scilab/modules/functions/help/en_US/listfunctions.xml
@@ -2,7 +2,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="en" xml:id="listfunctions">
     <refnamediv>
         <refname>listfunctions</refname>
-        <refpurpose>properties of all functions in 
+        <refpurpose>properties of all functions in
             the workspace
         </refpurpose>
     </refnamediv>
@@ -16,38 +16,43 @@
             <varlistentry>
                 <term>scope</term>
                 <listitem>
-                    <para>string, "local" (default) or "global"
+                    <para>
+                        a string, <literal>"local"</literal> (default) or <literal>"global"</literal>.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>flist</term>
                 <listitem>
-                    <para>string array, names of all the function variables in the specified namespace
+                    <para>
+                        a string array, names of all the function variables in the specified namespace.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>compiled</term>
                 <listitem>
-                    <para>boolean array, true if the corresponding element of flist is of type=13
+                    <para>
+                        a boolean array, true if the corresponding element of <varname>flist</varname> is of type 13.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>profilable</term>
                 <listitem>
-                    <para>boolean array, true if the corresponding element of flist is of type=13, 
+                    <para>
+                        a boolean array, true if the corresponding element of <varname>flist</varname> is of type 13,
                         and additionally profiling information is found in the pseudocode of
-                        the function
+                        the function.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>called</term>
                 <listitem>
-                    <para>uint32 array, number of times the corresponding element of flist has been
-                        already called (nonzero only for profilable functions)
+                    <para>
+                        an uint32 array, number of times the corresponding element of <varname>flist</varname> has been
+                        already called (nonzero only for profilable functions).
                     </para>
                 </listitem>
             </varlistentry>
@@ -58,17 +63,17 @@
         <itemizedlist>
             <listitem>
                 <para>
-                    This function checks all the variables in the workspace (given by 
+                    This function checks all the variables in the workspace (given by
                     <link linkend="who">who</link>) and collects those of type 11 or 13; for the latter,
-                    lst=<link linkend="macr2lst">macr2lst</link>(fun) is called, in order to check for the magic
-                    profiling entry at the end of the first codeline, i.e. lst(5)(1)=="25".
+                    <code>lst = macr2lst(fun)</code> is called, in order to check for the magic
+                    profiling entry at the end of the first codeline, i.e. <code>lst(5)(1)=="25"</code>.
                 </para>
             </listitem>
         </itemizedlist>
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 recompilefunction("asinh","p")
 [flist,compiled,profilable,called] = listfunctions();
 flist(profilable)
@@ -93,11 +98,17 @@ flist(profilable)
                 <link linkend="fun2string">fun2string</link>
             </member>
             <member>
+                <link linkend="macr2lst">macr2lst</link>
+            </member>
+            <member>
                 <link linkend="profile">profile</link>
             </member>
             <member>
                 <link linkend="recompilefunction">recompilefunction</link>
             </member>
+            <member>
+                <link linkend="who">who</link>
+            </member>
         </simplelist>
     </refsection>
     <refsection>
diff --git a/scilab/modules/functions/help/ja_JP/listfunctions.xml b/scilab/modules/functions/help/ja_JP/listfunctions.xml
index 293e649..56be924 100644
--- a/scilab/modules/functions/help/ja_JP/listfunctions.xml
+++ b/scilab/modules/functions/help/ja_JP/listfunctions.xml
@@ -16,14 +16,15 @@
             <varlistentry>
                 <term>scope</term>
                 <listitem>
-                    <para>文字列, "local" (デフォルト) または "global"
+                    <para>
+                        文字列, <literal>"local"</literal> (デフォルト) または <literal>"global"</literal>
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>flist</term>
                 <listitem>
-                    <para>文字列の配列, 
+                    <para>文字列の配列,
                         指定した名前空間にある全関数変数の名前
                     </para>
                 </listitem>
@@ -31,16 +32,16 @@
             <varlistentry>
                 <term>compiled</term>
                 <listitem>
-                    <para>論理値配列, 
-                        対応するflistの要素が型=13の場合に真
+                    <para>論理値配列,
+                        対応する<varname>flist</varname>の要素が型=13の場合に真
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>profilable</term>
                 <listitem>
-                    <para>論理値配列, 
-                        対応するflistの要素が型=13の場合に真となり,
+                    <para>論理値配列,
+                        対応する<varname>flist</varname>の要素が型=13の場合に真となり,
                         プロファイル情報が関数の擬似コードの中に追加されます.
                     </para>
                 </listitem>
@@ -48,8 +49,8 @@
             <varlistentry>
                 <term>called</term>
                 <listitem>
-                    <para>uint32 配列, 
-                        flist の対応する要素がコールされた回数
+                    <para>uint32 配列,
+                        <varname>flist</varname> の対応する要素がコールされた回数
                         (プロファイル可能な関数の場合のみ非ゼロ)
                     </para>
                 </listitem>
@@ -64,17 +65,17 @@
                     この関数は,(<link linkend="who">who</link>で指定した)
                     ワークスペースの全ての変数を確認し,
                     型11または13の変数を収集します;
-                    後で, lst=<link linkend="macr2lst">macr2lst</link>(fun) が
+                    後で, <code>lst = macr2lst(fun)</code> が
                     コールされた際,
                     最初のコード行の末尾に特殊なプロファイルエントリ
-                    lst(5)(1)=="25" がチェックされます.
+                    <code>lst(5)(1)=="25"</code> がチェックされます.
                 </para>
             </listitem>
         </itemizedlist>
     </refsection>
     <refsection>
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 recompilefunction("asinh","p")
 [flist,compiled,profilable,called] = listfunctions();
 flist(profilable)
@@ -99,11 +100,17 @@ flist(profilable)
                 <link linkend="fun2string">fun2string</link>
             </member>
             <member>
+                <link linkend="macr2lst">macr2lst</link>
+            </member>
+            <member>
                 <link linkend="profile">profile</link>
             </member>
             <member>
                 <link linkend="recompilefunction">recompilefunction</link>
             </member>
+            <member>
+                <link linkend="who">who</link>
+            </member>
         </simplelist>
     </refsection>
     <refsection>
diff --git a/scilab/modules/functions/help/pt_BR/listfunctions.xml b/scilab/modules/functions/help/pt_BR/listfunctions.xml
index f2f35f0..eed04b3 100644
--- a/scilab/modules/functions/help/pt_BR/listfunctions.xml
+++ b/scilab/modules/functions/help/pt_BR/listfunctions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="listfunctions" xml:lang="en">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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="listfunctions" xml:lang="pt">
     <refnamediv>
         <refname>listfunctions</refname>
         <refpurpose>propriedades de todas as funções no espaço de
@@ -16,7 +16,9 @@
             <varlistentry>
                 <term>scope</term>
                 <listitem>
-                    <para>string, "local" (padrão) ou "global"</para>
+                    <para>
+                        string, <literal>"local"</literal> (padrão) ou <literal>"global"</literal>
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
@@ -31,7 +33,7 @@
                 <term>compiled</term>
                 <listitem>
                     <para>array de booleanos, verdadeiro se o elemento correspondente de
-                        flist for do tipo 13
+                        <varname>flist</varname> for do tipo 13
                     </para>
                 </listitem>
             </varlistentry>
@@ -39,7 +41,7 @@
                 <term>profilable</term>
                 <listitem>
                     <para>array de booleanos, verdadeiro se o elemento correspondente de
-                        flist for do tipo 13, e adicionalmente informações sobre profiling
+                        <varname>flist</varname> for do tipo 13, e adicionalmente informações sobre profiling
                         forem encontradas no pseudo-código da função.
                     </para>
                 </listitem>
@@ -48,7 +50,7 @@
                 <term>called</term>
                 <listitem>
                     <para>array uint32, número de vezes que o elemento correspondente de
-                        flist foi chamado (não-zero apenas se a função possuir
+                        <varname>flist</varname> foi chamado (não-zero apenas se a função possuir
                         profiling)
                     </para>
                 </listitem>
@@ -61,16 +63,16 @@
             <listitem>
                 <para>Esta função verifica todas as variáveis do espaço de trabalho
                     (dadas por <link linkend="who">who</link>) e coleta aquelas de tipo 11
-                    ou 13; para as últimas, lst=<link linkend="macr2lst">macr2lst</link>(fun) é chamada, de modo a verificar
+                    ou 13; para as últimas, <code>lst = macr2lst(fun)</code> é chamada, de modo a verificar
                     a entrada para magic profiling ao fim da primeira linha de código,
-                    i.e. lst(5)(1)=="25".
+                    i.e. <code>lst(5)(1)=="25"</code>.
                 </para>
             </listitem>
         </itemizedlist>
     </refsection>
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 recompilefunction("asinh","p")
 [flist,compiled,profilable,called] = listfunctions();
 flist(profilable)
@@ -95,11 +97,17 @@ flist(profilable)
                 <link linkend="fun2string">fun2string</link>
             </member>
             <member>
+                <link linkend="macr2lst">macr2lst</link>
+            </member>
+            <member>
                 <link linkend="profile">profile</link>
             </member>
             <member>
                 <link linkend="recompilefunction">recompilefunction</link>
             </member>
+            <member>
+                <link linkend="who">who</link>
+            </member>
         </simplelist>
     </refsection>
     <refsection>
diff --git a/scilab/modules/functions/help/ru_RU/listfunctions.xml b/scilab/modules/functions/help/ru_RU/listfunctions.xml
new file mode 100644
index 0000000..bd13b34
--- /dev/null
+++ b/scilab/modules/functions/help/ru_RU/listfunctions.xml
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<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="listfunctions">
+    <refnamediv>
+        <refname>listfunctions</refname>
+        <refpurpose>
+            свойства всех функций в рабочем пространстве
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>
+            [flist,compiled,profilable,called] = listfunctions([scope])
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>scope</term>
+                <listitem>
+                    <para>
+                        строка, <literal>"local"</literal> (по умолчанию) или <literal>"global"</literal>.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>flist</term>
+                <listitem>
+                    <para>
+                        массив строк, имена всех переменных-функций в
+                        указанном рабочем пространстве.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>compiled</term>
+                <listitem>
+                    <para>
+                        массив логических значений, ИСТИНА, если
+                        соответствующий элемент из списка
+                        <varname>flist</varname> имеет тип 13.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>profilable</term>
+                <listitem>
+                    <para>
+                        массив логических значений, ИСТИНА, если
+                        соответствующий элемент из списка
+                        <varname>flist</varname> имеет тип 13 и к тому
+                        же в псевдокоде функции найдена информация
+                        профилирования.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>called</term>
+                <listitem>
+                    <para>
+                        массив значений типа uint32, количество раз,
+                        когда соответствующий элемент из списка
+                        <varname>flist</varname> уже был вызван
+                        (ненулевой только для профилируемых функций).
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    Эта функция проверяет все переменные в рабочем
+                    пространстве (указанные с помощью функции
+                    <link linkend="who">who</link>) и собирает те,
+                    которые имеют тип 11 или 13; для последних
+                    вызывается <code>lst = macr2lst(fun)</code> для
+                    того, чтобы проверить магический вход профилирования
+                    в конце первой строки кода, т. е. <code>lst(5)(1)=="25"</code>.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+recompilefunction("asinh","p")
+[flist,compiled,profilable,called] = listfunctions();
+flist(profilable)
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="function">function</link>
+            </member>
+            <member>
+                <link linkend="exec">exec</link>
+            </member>
+            <member>
+                <link linkend="deff">deff</link>
+            </member>
+            <member>
+                <link linkend="comp">comp</link>
+            </member>
+            <member>
+                <link linkend="fun2string">fun2string</link>
+            </member>
+            <member>
+                <link linkend="macr2lst">macr2lst</link>
+            </member>
+            <member>
+                <link linkend="profile">profile</link>
+            </member>
+            <member>
+                <link linkend="recompilefunction">recompilefunction</link>
+            </member>
+            <member>
+                <link linkend="who">who</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>Литература</title>
+        <para>
+            <ulink url="http://wiki.scilab.org/Scilab_function_variables%3A_representation%2C_manipulation">http://wiki.scilab.org/Scilab_function_variables%3A_representation%2C_manipulation</ulink>
+        </para>
+    </refsection>
+</refentry>
-- 
1.7.9.5