Revision of help pages for bytecode function 23/13223/2
Stanislav KROTER [Mon, 25 Nov 2013 15:32:49 +0000 (21:32 +0600)]
Added russian help page for bytecode function.

Change-Id: Ie29c2f2435ffa623d899313b13e426139c2d28db

scilab/modules/functions/help/en_US/bytecode.xml
scilab/modules/functions/help/fr_FR/bytecode.xml
scilab/modules/functions/help/ja_JP/bytecode.xml
scilab/modules/functions/help/pt_BR/bytecode.xml
scilab/modules/functions/help/ru_RU/bytecode.xml [new file with mode: 0644]

index a796dfa..23f1412 100644 (file)
@@ -9,7 +9,7 @@
  * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *-->
-<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="fr" xml:id="bytecode">
+<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="bytecode">
     <refnamediv>
         <refname>bytecode</refname>
         <refpurpose>given a function returns the "bytecode" of a function in a Scilab array and conversely. </refpurpose>
@@ -18,7 +18,7 @@
         <title>Calling Sequence</title>
         <synopsis>
             x = bytecode(f)
-            f= bytecode(X)
+            f = bytecode(x)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
@@ -28,7 +28,7 @@
                 <term>f</term>
                 <listitem>
                     <para>
-                        A scilab function.
+                        A Scilab function.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>x= bytecode(f) </literal> returns the "bytecode" of
-            the function <literal>f</literal> in the Scilab integer array
-            <literal>x</literal>.
+            <code>x = bytecode(f)</code> returns the "bytecode" of
+            the function <varname>f</varname> in the Scilab integer array
+            <varname>x</varname>.
         </para>
         <para>
-            <literal>f= bytecode(x) </literal> returns in
-            <literal>f</literal> the function associated with the
+            <code>f= bytecode(x)</code> returns in
+            <varname>f</varname> the function associated with the
             "bytecode" given in the Scilab integer array
-            <literal>x</literal>. Warning the validity of
-            <literal>x</literal> is not checked.
+            <varname>x</varname>.
+            <warning>
+                Warning: the validity of <varname>x</varname> is not checked.
+            </warning>
         </para>
     </refsection>
     <refsection>
         <title>Remark</title>
         <para>
             The bytecode of Scilab function will evolve drastically in the
-            future, So the use of this function should be restricted to the
+            future, so the use of this function should be restricted to the
             profiling instruction handling.
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 function a=foo(),a=sin(3),endfunction
 bytecode(foo)
  ]]></programlisting>
index 058bf73..04bea30 100644 (file)
@@ -18,7 +18,7 @@
         <title>Séquence d'appel</title>
         <synopsis>
             x = bytecode(f)
-            f= bytecode(X)
+            f = bytecode(x)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
@@ -36,7 +36,7 @@
                 <term>x</term>
                 <listitem>
                     <para>
-                        un vecteur d'entiers, 
+                        un vecteur d'entiers,
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>x= bytecode(f) </literal> retourne le pseudo code de la fonction
-            <literal>f</literal> dans le vecteur d'entiers Scilab
-            <literal>x</literal>.
+            <code>x = bytecode(f)</code> retourne le pseudo code de la fonction
+            <varname>f</varname> dans le vecteur d'entiers Scilab
+            <varname>x</varname>.
         </para>
         <para>
-            <literal>f= bytecode(x) </literal> retourne dans
-            <literal>f</literal> la fonction correspondant au pseudo code
+            <code>f= bytecode(x)</code> retourne dans
+            <varname>f</varname> la fonction correspondant au pseudo code
             donné dans le vecteur d'entiers
-            <literal>x</literal>. Attention la validité du pseudo code
-            n'est pas vérifiée.
+            <varname>x</varname>.
+            <warning>
+                Attention la validité du pseudo code n'est pas vérifiée.
+            </warning>
         </para>
     </refsection>
     <refsection>
@@ -67,7 +69,7 @@
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 function a=foo(),a=sin(3),endfunction
 bytecode(foo)
  ]]></programlisting>
index 06c4f9d..60a122a 100644 (file)
@@ -21,7 +21,7 @@
         <title>呼び出し手順</title>
         <synopsis>
             x = bytecode(f)
-            f= bytecode(X)
+            f = bytecode(x)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
     <refsection>
         <title>説明</title>
         <para>
-            <literal>x= bytecode(f) </literal> は,
-            Scilab関数 <literal>f</literal> の "バイトコード"を
-            整数配列<literal>x</literal>に返します.
+            <code>x = bytecode(f)</code> は,
+            Scilab関数 <varname>f</varname> の "バイトコード"を
+            整数配列<varname>x</varname>に返します.
         </para>
         <para>
-            <literal>f= bytecode(x) </literal> は,
-            Scilabの整数配列 <literal>x</literal> で指定した
-            "バイトコード"が示す関数 <literal>f</literal> を
+            <code>f= bytecode(x)</code> は,
+            Scilabの整数配列 <varname>x</varname> で指定した
+            "バイトコード"が示す関数 <varname>f</varname> を
             返します.
-            <literal>x</literal> の有効性は確認されないことに
+            <varname>x</varname> の有効性は確認されないことに
             注意してください.
         </para>
     </refsection>
@@ -70,7 +70,7 @@
     </refsection>
     <refsection>
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 function a=foo(),a=sin(3),endfunction
 bytecode(foo)
  ]]></programlisting>
index db92583..7af6fd4 100644 (file)
@@ -9,7 +9,7 @@
  * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *-->
-<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="bytecode" xml:lang="fr">
+<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="bytecode" xml:lang="pt">
     <refnamediv>
         <refname>bytecode</refname>
         <refpurpose>dada uma função, retorna "bytecode" (código de bytes) da
@@ -20,7 +20,7 @@
         <title>Seqüência de Chamamento</title>
         <synopsis>
             x = bytecode(f)
-            f= bytecode(X)
+            f = bytecode(x)
         </synopsis>
     </refsynopsisdiv>
     <refsection>
     <refsection>
         <title>Descrição</title>
         <para>
-            <literal>x= bytecode(f) </literal>retorna o "bytecode" da função
-            <literal>f</literal> no array Scilab de inteiros
-            <literal>x</literal>.
+            <code>x = bytecode(f)</code> retorna o "bytecode" da função
+            <varname>f</varname> no array Scilab de inteiros
+            <varname>x</varname>.
         </para>
         <para>
-            <literal>f= bytecode(x) </literal>retorna em <literal>f</literal> a
+            <code>f= bytecode(x)</code> retorna em <varname>f</varname> a
             função associada ao "bytecode" dado no array Scilab de inteiros
-            <literal>x</literal>. AVISO: a validade de <literal>x</literal> não é
-            verificada.
+            <varname>x</varname>.
+            <warning>
+                AVISO: a validade de <varname>x</varname> não é
+                verificada.
+            </warning>
         </para>
     </refsection>
     <refsection>
@@ -63,7 +66,7 @@
     </refsection>
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 function a=foo(),a=sin(3),endfunction
 bytecode(foo)
  ]]></programlisting>
diff --git a/scilab/modules/functions/help/ru_RU/bytecode.xml b/scilab/modules/functions/help/ru_RU/bytecode.xml
new file mode 100644 (file)
index 0000000..2ca37b9
--- /dev/null
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) ????-2008 - INRIA Serge Steer
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution.  The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *-->
+<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="bytecode">
+    <refnamediv>
+        <refname>bytecode</refname>
+        <refpurpose>
+            возвращает "байт-код" указанной функции в виде Scilab-массива и наоборот.
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>
+            x = bytecode(f)
+            f = bytecode(x)
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>f</term>
+                <listitem>
+                    <para>
+                        Scilab-функция.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>x</term>
+                <listitem>
+                    <para>
+                        вектор-строка значений типа int32
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            <code>x = bytecode(f)</code> возвращает "байт-код" функции
+            <varname>f</varname> в виде целочисленного массива
+            <varname>x</varname>.
+        </para>
+        <para>
+            <code>f= bytecode(x)</code> возвращает в <varname>f</varname>
+            функцию, связанную с "байт-кодом", заданным в целочисленном
+            массиве <varname>x</varname>.
+            <warning>
+                Внимание: корректность <varname>x</varname> не проверяется.
+            </warning>
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примечание</title>
+        <para>
+            Байт-код Scilab-функции будет в будущем значительно преобразован, поэтому использование этой функции должно быть ограничено обработкой инструкций профилирования.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+function a=foo(),a=sin(3),endfunction
+bytecode(foo)
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="add_profiling">add_profiling</link>
+            </member>
+            <member>
+                <link linkend="bytecodewalk">bytecodewalk</link>
+            </member>
+            <member>
+                <link linkend="macr2lst">macr2lst</link>
+            </member>
+            <member>
+                <link linkend="macr2tree">macr2tree</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>