Revision of help pages for deff function 60/13260/2
Stanislav KROTER [Wed, 27 Nov 2013 14:18:54 +0000 (20:18 +0600)]
Added russian translation of this help page.

Change-Id: Ia46c6452fa95fd77a97e64da6c96e6753d762873

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

index 2655023..d9bcc35 100644 (file)
@@ -2,11 +2,11 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
- * 
+ *
  * 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    
+ * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
     </refnamediv>
     <refsynopsisdiv>
         <title>Calling Sequence</title>
-        <synopsis>deff('[s1,s2,...]=newfunction(e1,e2,....)',text [,opt])</synopsis>
+        <synopsis>deff('[s1, s2, ...] = newfunction(e1, e2, ...)',text [,opt])</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Arguments</title>
         <variablelist>
             <varlistentry>
-                <term>e1,e2,...,  </term>
+                <term>e1, e2, ...</term>
                 <listitem>
                     <para>input variables.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>s1,s2,...,  </term>
+                <term>s1, s2, ...</term>
                 <listitem>
                     <para>output variables.</para>
                 </listitem>
             <varlistentry>
                 <term>text</term>
                 <listitem>
-                    <para>matrix of character strings</para>
+                    <para>a matrix of character strings.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>opt</term>
                 <listitem>
-                    <para>optional character string</para>
+                    <para>an optional character string:</para>
                     <variablelist>
                         <varlistentry>
-                            <term>'c'  </term>
+                            <term>'c'</term>
                             <listitem>
-                                <para>function is "compiled" to be more efficient (default)</para>
+                                <para>function is "compiled" to be more efficient (default);</para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
-                            <term>'p'  </term>
+                            <term>'p'</term>
                             <listitem>
-                                <para>function is "compiled" and prepared for profiling (see profile)</para>
+                                <para>
+                                    function is "compiled" and prepared for profiling (see help <link linkend="profile">profile</link>);
+                                </para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
-                            <term>'n'  </term>
+                            <term>'n'</term>
                             <listitem>
-                                <para>function is not "compiled"</para>
+                                <para>function is not "compiled".</para>
                             </listitem>
                         </varlistentry>
                     </variablelist>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>deff</literal> can be used to define functions from sequences of instructions
+            <function>deff</function> can be used to define functions from sequences of instructions
             written in text strings. The resulting function object has the same properties
-            of any other function defined in a text file and loaded with <literal>exec</literal>.
+            of any other function defined in a text file and loaded with <function>exec</function>.
         </para>
         <para>
-            Quotes in the instructions (delimiting strings or meaning matrix transposition) 
-            have to be doubled to be interpreted correctly (see help quote). This can make
+            Quotes in the instructions (delimiting strings or meaning matrix transposition)
+            have to be doubled to be interpreted correctly (see help <link linkend="quote">quote</link>). This can make
             writing up a little awkward.
             An option in such cases is to define functions in files as usual, to load them into
-            Scilab by <literal>exec</literal> (with the <literal>'n'</literal> option) and to use 
-            <literal>sci2exp</literal> to get a printout of corresponding <literal>deff</literal> 
+            Scilab by <function>exec</function> (with the <literal>'n'</literal> option) and to use
+            <function>sci2exp</function> to get a printout of corresponding <function>deff</function>
             instructions.
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 deff('[x]=myplus(y,z)','x=y+z')
 
 deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
@@ -108,6 +110,9 @@ deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
             <member>
                 <link linkend="profile">profile</link>
             </member>
+            <member>
+                <link linkend="quote">quote</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index 8884d57..d25bfe2 100644 (file)
@@ -2,11 +2,11 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
- * 
+ *
  * 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    
+ * are also available at
  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
-        <synopsis>deff('[s1,s2,...]=newfunction(e1,e2,....)',text [,opt])</synopsis>
+        <synopsis>deff('[s1, s2,...] = newfunction(e1, e2,...)',text [,opt])</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>パラメータ</title>
         <variablelist>
             <varlistentry>
-                <term>e1,e2,...,  </term>
+                <term>e1, e2, ...</term>
                 <listitem>
                     <para>入力変数.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>s1,s2,...,  </term>
+                <term>s1, s2, ...</term>
                 <listitem>
                     <para>出力変数.</para>
                 </listitem>
             <varlistentry>
                 <term>opt</term>
                 <listitem>
-                    <para>オプションの文字列</para>
+                    <para>オプションの文字列:</para>
                     <variablelist>
                         <varlistentry>
-                            <term>'c'  </term>
+                            <term>'c'</term>
                             <listitem>
-                                <para>実行効率改善のために関数は "コンパイル" されます (デフォルト)</para>
+                                <para>実行効率改善のために関数は "コンパイル" されます (デフォルト);</para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
-                            <term>'p'  </term>
+                            <term>'p'</term>
                             <listitem>
                                 <para>関数は"コンパイル"され,
-                                    プロファイルに備えます (profile参照)
+                                    プロファイルに備えます (<link linkend="profile">profile</link>参照);
                                 </para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
-                            <term>'n'  </term>
+                            <term>'n'</term>
                             <listitem>
-                                <para>関数は"コンパイル"されません</para>
+                                <para>関数は"コンパイル"されません.</para>
                             </listitem>
                         </varlistentry>
                     </variablelist>
     <refsection>
         <title>説明</title>
         <para>
-            <literal>deff</literal> はテキスト文字列で記述された一連の命令から
+            <function>deff</function> はテキスト文字列で記述された一連の命令から
             関数を定義する際に使用されます.
             得られる関数オブジェクトはテキストファイルで定義され,
-            <literal>exec</literal> または <literal>exec</literal> で
+            <function>exec</function> または <function>exec</function> で
             定義された他の関数と同じ特性を有しています.
         </para>
         <para>
             命令の中の引用符(文字列の区切りまたは行列の転置を意味する)は,
-            ただしく解釈されるように二重化する必要があります(quoteのヘルプを参照).
+            ただしく解釈されるように二重化する必要があります(<link linkend="quote">quote</link>のヘルプを参照).
             この仕様のため,作成作業はやや不便となります.
             このような場合のオプションとしては,通常と同様に関数を
             ファイルで定義し,
             (<literal>'n'</literal> オプションを付けて)
-            <literal>exec</literal>によりScilabにロードし,
-            <literal>deff</literal> 命令と同じ出力を得るために
-            <literal>sci2exp</literal>を使用するという方法があります.
+            <function>exec</function>によりScilabにロードし,
+            <function>deff</function> 命令と同じ出力を得るために
+            <function>sci2exp</function>を使用するという方法があります.
         </para>
     </refsection>
     <refsection>
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 deff('[x]=myplus(y,z)','x=y+z')
 
 deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
@@ -114,6 +114,9 @@ deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
             <member>
                 <link linkend="profile">profile</link>
             </member>
+            <member>
+                <link linkend="quote">quote</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index 7427b2d..b7799bc 100644 (file)
@@ -2,54 +2,54 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) XXXX-2008 - INRIA
- * 
+ *
  * 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    
+ * 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:ns3="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="deff" 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:ns3="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="deff" xml:lang="pt">
     <refnamediv>
         <refname>deff</refname>
         <refpurpose>definição on-line de função</refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
-        <synopsis>deff('[s1,s2,...]=newfunction(e1,e2,....)',text [,opt])</synopsis>
+        <synopsis>deff('[s1, s2, ...] = newfunction(e1, e2,...)',text [,opt])</synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Parâmetros</title>
         <variablelist>
             <varlistentry>
-                <term>e1,e2,...,</term>
+                <term>e1, e2, ...</term>
                 <listitem>
-                    <para>variáveis de entrada</para>
+                    <para>variáveis de entrada.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>s1,s2,...,</term>
+                <term>s1, s2, ...</term>
                 <listitem>
-                    <para>variáveis de saída</para>
+                    <para>variáveis de saída.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>text</term>
                 <listitem>
-                    <para>matriz de strings</para>
+                    <para>matriz de strings.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>opt</term>
                 <listitem>
-                    <para>string opcional</para>
+                    <para>string opcional:</para>
                     <variablelist>
                         <varlistentry>
                             <term>'c'</term>
                             <listitem>
                                 <para>a função é "compilada" para ser eficiente
-                                    (padrão)
+                                    (padrão);
                                 </para>
                             </listitem>
                         </varlistentry>
                             <term>'p'</term>
                             <listitem>
                                 <para>a função é compilada e preparada para profiling (ver
-                                    profile)
+                                    <link linkend="profile">profile</link>);
                                 </para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
                             <term>'n'</term>
                             <listitem>
-                                <para>a função não é "compilada"</para>
+                                <para>a função não é "compilada".</para>
                             </listitem>
                         </varlistentry>
                     </variablelist>
     <refsection>
         <title>Descrição</title>
         <para>
-            <literal>deff</literal> pode ser usada para definir funções de
+            <function>deff</function> pode ser usada para definir funções de
             seqüências de instruções escritas em strings de textos. Objeto função
             resultante tem as mesmas propriedades que qualquer outra função definida
-            em um arquivo de texto e carregada através de <literal>exec</literal> ou
-            <literal>exec</literal>.
+            em um arquivo de texto e carregada através de <function>exec</function> ou
+            <function>exec</function>.
         </para>
         <para>Aspas em instruções (delimitando strings ou indicando transposição
             de matrizes) devem ser dobradas para serem interpretadas corretamente (ver
             quote). Isto pode tornar a escrita um tanto estranha. Uma alternativa em
             tais casos é definir funções em arquivos, como de uso, para carregá-las no
-            Scilab através de <literal>exec</literal> (com a opção
-            <literal>'n'</literal>) e utilizar <literal>sci2exp</literal> para uma
-            impressão das instruções <literal>deff</literal> correspondentes.
+            Scilab através de <function>exec</function> (com a opção
+            <literal>'n'</literal>) e utilizar <function>sci2exp</function> para uma
+            impressão das instruções <function>deff</function> correspondentes.
         </para>
     </refsection>
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 deff('[x]=myplus(y,z)','x=y+z')
 
 deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
@@ -113,6 +113,9 @@ deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
             <member>
                 <link linkend="profile">profile</link>
             </member>
+            <member>
+                <link linkend="quote">quote</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
diff --git a/scilab/modules/functions/help/ru_RU/deff.xml b/scilab/modules/functions/help/ru_RU/deff.xml
new file mode 100644 (file)
index 0000000..bfa3556
--- /dev/null
@@ -0,0 +1,128 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) XXXX-2008 - INRIA
+ *
+ * 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="deff">
+    <refnamediv>
+        <refname>deff</refname>
+        <refpurpose>
+            определение функции во время выполнения программы
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>deff('[s1, s2, ...] = newfunction(e1, e2, ...)',text [,opt])</synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>e1, e2, ...</term>
+                <listitem>
+                    <para>входные переменные.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>s1, s2, ...</term>
+                <listitem>
+                    <para>выходные переменные.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>text</term>
+                <listitem>
+                    <para>матрица символьных строк.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>opt</term>
+                <listitem>
+                    <para>необязательная символьная строка:</para>
+                    <variablelist>
+                        <varlistentry>
+                            <term>'c'</term>
+                            <listitem>
+                                <para>
+                                    функция "скомпилирована" для большей производительности (по умолчанию);
+                                </para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>'p'</term>
+                            <listitem>
+                                <para>
+                                    функция "скомпилирована" и подготовлена к профилированию (см. справку <link linkend="profile">profile</link>);
+                                </para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>'n'</term>
+                            <listitem>
+                                <para>
+                                    функция не "скомпилирована".
+                                </para>
+                            </listitem>
+                        </varlistentry>
+                    </variablelist>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Функция <function>deff</function> может быть использована
+            для определения функций из ряда инструкций, написанных в
+            текстовых строках. Полученный объект функции имеет те же
+            свойства, что и любая другая функция, определённая в
+            текстовом файле и загруженная с помощью функции
+            <function>exec</function>.
+        </para>
+        <para>
+            Кавычки в инструкциях (разделяющие строки или означающие
+            транспонирование матрицы) должны быть удвоены для правильной
+            интерпретации (см. справку <link linkend="quote">кавычки</link>). Это может сделать написание
+            несколько неудобным. Как вариант, в таких случаях можно
+            определять функции в файлах, как обычно, для загрузки их в
+            Scilab с помощью функции <function>exec</function> (с опцией
+            <literal>'n'</literal>) и можно использовать функцию
+            <function>sci2exp</function> для получения распечатки
+            соответствующих инструкций в функции <function>deff</function>.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+deff('[x]=myplus(y,z)','x=y+z')
+deff('[x]=mymacro(y,z)',['a=3*y+1'; 'x=a*z+y'])
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="comp">comp</link>
+            </member>
+            <member>
+                <link linkend="exec">exec</link>
+            </member>
+            <member>
+                <link linkend="function">function</link>
+            </member>
+            <member>
+                <link linkend="profile">profile</link>
+            </member>
+            <member>
+                <link linkend="quote">quote</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>