Revision of help page for macr2lst function 12/13312/3
Stanislav KROTER [Tue, 3 Dec 2013 15:02:21 +0000 (21:02 +0600)]
Change-Id: I53561e9cb5b9a3082d235966e87a93391ba4d205

scilab/modules/functions/help/en_US/macr2lst.xml
scilab/modules/functions/help/ja_JP/macr2lst.xml
scilab/modules/functions/help/pt_BR/macr2lst.xml
scilab/modules/functions/help/ru_RU/macr2lst.xml

index efeae42..9280b20 100644 (file)
@@ -6,24 +6,40 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>[txt]=macr2lst(function_name)</synopsis>
+        <synopsis>lst = macr2lst(function_name)</synopsis>
     </refsynopsisdiv>
     <refsection>
+        <title>Arguments</title>
+        <variablelist>
+            <varlistentry>
+                <term>function_name</term>
+                <listitem>
+                    <para>a function to be converted.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>lst</term>
+                <listitem>
+                    <para>a list.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
         <title>Description</title>
         <para>
-            This primitive converts a compiled Scilab function <literal>function_name</literal>
+            This primitive converts a compiled Scilab function <varname>function_name</varname>
             into a list which codes the internal representation of
             the function (reverse Polish notation).
         </para>
         <para>The first entry of the list is the function name, the second
             and third are respectively the vectors of left hand side variables
-            and right hand side variables names. The following entries are either basic operation records 
-            
+            and right hand side variables names. The following entries are either basic operation records
             either lists with contains the hierarchical control structures like
-            <literal>if</literal>, <literal>for</literal>, ... 
+            <literal>if</literal>, <literal>for</literal>, ...
         </para>
         <para>Basic operation records are described by a character string
-            vector whose first element represents the opcode. 
+            vector whose first element represents the opcode.
         </para>
         <informaltable border="1">
             <tr>
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 //DISPLAY
 function y=foo(x,flag)
-  if flag then 
+  if flag then
     y=sin(x)
   else
     y=cos(x)
index 9e4e146..11e789a 100644 (file)
@@ -6,23 +6,40 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>[txt]=macr2lst(function-name)</synopsis>
+        <synopsis>lst = macr2lst(function_name)</synopsis>
     </refsynopsisdiv>
     <refsection>
+        <title>Arguments</title>
+        <variablelist>
+            <varlistentry>
+                <term>function_name</term>
+                <listitem>
+                    <para>a function to be converted.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>lst</term>
+                <listitem>
+                    <para>a list.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
         <title>説明</title>
         <para>
-            このプリミティブは,コンパイル済みのScilab関数 <literal>function-name</literal>
+            このプリミティブは,コンパイル済みのScilab関数 <varname>function_name</varname>
             を,関数の内部表現をコード化(逆ポーランド表記)したリストに変換します.
         </para>
         <para>
             リストの最初のエントリは関数名,2番目および3番目のエントリは
             それぞれ左辺引数および右辺引数の変数名となります.
             それ以降のエントリは,基本的な演算子レコードもしくは
-            if, for, ... のような制御構造の階層を含むリストのどちらかです.
+            <literal>if</literal>, <literal>for</literal>, ... のような制御構造の階層を含むリストのどちらかです.
         </para>
         <para>
             基本的な演算子レコードは, 文字列ベクトルにより記述されます.
-            その最初の要素はオペコードを表します. 
+            その最初の要素はオペコードを表します.
         </para>
         <informaltable border="1">
             <tr>
     </refsection>
     <refsection>
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 //DISPLAY
 function y=foo(x,flag)
-  if flag then 
+  if flag then
     y=sin(x)
   else
     y=cos(x)
index 0ceb5aa..06d6819 100644 (file)
@@ -6,19 +6,35 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
-        <synopsis>[txt]=macr2lst(function-name)</synopsis>
+        <synopsis>lst = macr2lst(function_name)</synopsis>
     </refsynopsisdiv>
     <refsection>
+        <title>Arguments</title>
+        <variablelist>
+            <varlistentry>
+                <term>function_name</term>
+                <listitem>
+                    <para>a function to be converted.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>lst</term>
+                <listitem>
+                    <para>a list.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
         <title>Descrição</title>
         <para>Esta primitiva converte uma versão compilada do Scilab
-            <literal>function-name</literal> em uma lista que codifica a representação
+            <varname>function_name</varname> em uma lista que codifica a representação
             interna da função (notação polonesa inversa).
         </para>
         <para>A primeira entrada da lista é o nome da função, as segunda e
             terceira são, respectivamente, os vetores das variáveis de lado esquerdo e
             direito (lhs e rhs). As entradas seguintes são registros de operação
-            básica ou listas que contém as estruturas de controle hierárquicas como if
-            , for, ...
+            básica ou listas que contém as estruturas de controle hierárquicas como <literal>if</literal>, <literal>for</literal>, ...
         </para>
         <para>Registros de operação básica são descritos por um vetor de strings
             cujo primeiro elemento representa código do operador (op code).
     </refsection>
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 //EXIBIÇÃO
 function y=foo(x,flag)
-  if flag then 
+  if flag then
     y=sin(x)
   else
     y=cos(x)
index d764c40..d5893f2 100644 (file)
@@ -6,21 +6,40 @@
     </refnamediv>
     <refsynopsisdiv>
         <title>Последовательность вызова</title>
-        <synopsis>[txt]=macr2lst(function_name)</synopsis>
+        <synopsis>lst = macr2lst(function_name)</synopsis>
     </refsynopsisdiv>
     <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>function_name</term>
+                <listitem>
+                    <para>
+                        функция, которую требуется преобразовать.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>lst</term>
+                <listitem>
+                    <para>список.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
         <title>Описание</title>
         <para>
-            Этот примитив преобразует компилированную функцию Scilab с именем
-            <literal>function_name</literal> в список, который кодирует внутреннее
+            Этот примитив преобразует компилированную функцию Scilab
+            <varname>function_name</varname> в список, который кодирует внутреннее
             представление функции (обратная бесскобочная запись).
         </para>
         <para>
-            Первый элемент списка является именем функции, второй и третий являются, соответственно, именами выходных переменных и входных переменных. Следующие элементы являются или записями основных операций или списками, содержащими иерархическими управляющими структурами, такими, как 
-            <literal>if</literal> , <literal>for</literal>, ... 
+            Первый элемент списка является именем функции, второй и третий являются, соответственно, именами выходных переменных и входных переменных. Следующие элементы являются или записями основных операций или списками, содержащими иерархические управляющие структуры, такие, как
+            <literal>if</literal>, <literal>for</literal>, ...
         </para>
         <para>
-            Записи основных операций описываются вектором символьных строк, чей первый элемент представляет собой код операции. 
+            Записи основных операций описываются вектором символьных строк, чей первый элемент представляет собой код операции.
         </para>
         <informaltable border="1">
             <tr>
             </tr>
             <tr>
                 <td>"18"</td>
-                <td>поименованная переменная</td>
+                <td>именованная переменная</td>
                 <td>имя переменной</td>
             </tr>
             <tr>
                 <td>"19"</td>
-                <td>создать рекурсивную структуру индексов create recursive index structure</td>
-                <td>длина пути, количество конечных индексов path length, number of final indices</td>
+                <td>создать рекурсивную структуру индексов</td>
+                <td>длина пути, количество конечных индексов</td>
             </tr>
             <tr>
                 <td>"20"</td>
             </tr>
             <tr>
                 <td>"30"</td>
-                <td>логическое выражение logical expression short circuit</td>
-                <td>type, jump size</td>
+                <td>сокращённое вычисление логического выражения</td>
+                <td>тип, размер скачка</td>
             </tr>
             <tr>
                 <td>"31"</td>
             </tr>
             <tr>
                 <td> &gt; "100"</td>
-                <td>встроенный вызов builtin call (устарело)</td>
+                <td>встроенный вызов (устарело)</td>
                 <td>100*fun, #rhs, #lhs, fin</td>
             </tr>
         </informaltable>
     </refsection>
     <refsection>
         <title>Примеры</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 // ОТОБРАЖЕНИЕ
 function y=foo(x,flag)
-  if flag then 
+  if flag then
     y=sin(x)
   else
     y=cos(x)