Revision of help pages for exec and execstr functions 77/13277/2
Stanislav KROTER [Fri, 29 Nov 2013 13:48:46 +0000 (19:48 +0600)]
Added russian translations of these help pages.

Change-Id: Ic43ec56d1b70272ba70d4a3769d88bf06b2dd66a

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

index 6e0a1f7..56ad8a7 100644 (file)
@@ -8,8 +8,8 @@
         <title>Calling Sequence</title>
         <synopsis>exec(path [,mode])
             exec(fun [,mode])
-            ierr=exec(path,'errcatch' [,mode])
-            ierr=exec(fun,'errcatch' [,mode])
+            ierr = exec(path, 'errcatch' [,mode])
+            ierr = exec(fun, 'errcatch' [,mode])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>path</term>
                 <listitem>
-                    <para>a string, the path of the script file</para>
+                    <para>a string, the path of the script file.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>mode</term>
                 <listitem>
-                    <para>an integer scalar, the execution mode (see below)</para>
+                    <para>an integer scalar, the execution mode (see below).</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>fun</term>
                 <listitem>
-                    <para>a scilab function</para>
+                    <para>a Scilab function.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>ierr</term>
                 <listitem>
-                    <para>integer, 0 or error number</para>
+                    <para>an integer, 0 or error number.</para>
                 </listitem>
             </varlistentry>
         </variablelist>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>exec(path [,mode])</literal> executes sequentialy the scilab instructions
-            contained in the file given by <literal>path</literal>  with an optional 
-            execution mode <literal>mode</literal> .
+            <code>exec(path [,mode])</code> executes sequentially the Scilab instructions
+            contained in the file given by <varname>path</varname>  with an optional
+            execution mode <varname>mode</varname>.
         </para>
         <para>
-            The different cases for <literal>mode</literal> are :
-        </para>
-        <para>
-            0 
-            : the default value
-        </para>
-        <para>
-            -1 
-            : nothing is printed
-        </para>
-        <para>
-            1 
-            : echo of each command line
-        </para>
-        <para>
-            2 
-            : prompt <literal>--&gt;</literal> is printed
-        </para>
-        <para>
-            3 
-            : echoes + prompts
-        </para>
-        <para>
-            4 
-            : stops before each prompt. Execution resumes after a carriage return.
-        </para>
-        <para>
-            7 
-            : stops + prompts + echoes : useful mode for demos.
+            The different cases for <varname>mode</varname> are :
         </para>
+        <variablelist>
+            <varlistentry>
+                <term>0</term>
+                <listitem>
+                    <para>
+                        the default value.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>-1</term>
+                <listitem>
+                    <para>
+                        nothing is printed.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>1</term>
+                <listitem>
+                    <para>
+                        echo of each command line.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>2</term>
+                <listitem>
+                    <para>
+                        prompt <literal>--&gt;</literal> is printed.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>3</term>
+                <listitem>
+                    <para>
+                        echoes + prompts.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>4</term>
+                <listitem>
+                    <para>
+                        stops before each prompt. Execution resumes after a carriage return.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>7</term>
+                <listitem>
+                    <para>
+                        stops + prompts + echoes : useful mode for demos.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
         <para>
-            <literal>exec(fun [,mode])</literal> executes function  <literal>fun</literal> as a script: no
+            <code>exec(fun [,mode])</code> executes function  <varname>fun</varname> as a script: no
             input nor output argument nor specific variable environment. This form
-            is more efficient, because script code may be pre-compiled (see comp). This method for script evaluation allows to store scripts as
+            is more efficient, because script code may be pre-compiled (see <link linkend="comp">comp</link>). This method for script evaluation allows to store scripts as
             function in libraries.
         </para>
         <para>
-            If an error is encountered while executing, if 'errcatch' flag is
-            present <literal>exec</literal> issues no error message, aborts execution of the
-            instructions and resumes with <literal>ierr</literal> equal to the error
-            number. If 'errcatch' flag is not present, standard error handling
+            If an error is encountered while executing, if <literal>'errcatch'</literal> flag is
+            present <function>exec</function> issues no error message, aborts execution of the
+            instructions and resumes with <varname>ierr</varname> equal to the error
+            number. If <literal>'errcatch'</literal> flag is not present, standard error handling
             works.
         </para>
     </refsection>
     <refsection>
         <title>Remarks</title>
         <para>
-            <literal>exec</literal> files may now be used to define functions using the inline function definition syntax (see function).
+            <function>exec</function> files may now be used to define functions using the inline function definition syntax (see <link linkend="function">function</link>).
         </para>
         <para>
-            <literal>exec</literal> supports files encoded as ANSI/ASCII and UTF-8.
+            <function>exec</function> supports files encoded as ANSI/ASCII and UTF-8.
         </para>
-        <para>length of each line in a file is limited to 4096 characters.</para>
+        <para>The length of each line in a file is limited to 4096 characters.</para>
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 // create a script file
 mputl('a=1;b=2',TMPDIR+'/myscript')
 
@@ -127,7 +157,8 @@ exec(foo)
 
 // a and y are created in the current environment
 whos -name "a "
- ]]></programlisting>
+whos -name "y "
+]]></programlisting>
     </refsection>
     <refsection role="see also">
         <title>See Also</title>
index baab29a..2ec8112 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
  *
  -->
@@ -18,7 +18,7 @@
     <refsynopsisdiv>
         <title>Calling Sequence</title>
         <synopsis>execstr(instr)
-            ierr=execstr(instr,'errcatch' [,msg])
+            ierr = execstr(instr,'errcatch' [,msg])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
             <varlistentry>
                 <term>instr</term>
                 <listitem>
-                    <para>vector of character strings, Scilab instruction to be executed.</para>
+                    <para>a vector of character strings, Scilab instruction to be executed.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>ierr</term>
                 <listitem>
-                    <para>integer, 0 or error number.</para>
+                    <para>an integer, 0 or error number.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>msg</term>
                 <listitem>
                     <para>
-                        character string with values <literal>'m'</literal> or <literal>'n'</literal>.  Default value is <literal>'n'</literal>.
+                        a character string with values <literal>'m'</literal> or <literal>'n'</literal>.  Default value is <literal>'n'</literal>.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Description</title>
         <para>Executes the Scilab instructions given in argument
-            <literal>instr</literal>.
+            <varname>instr</varname>.
+        </para>
+        <note>
+            Note that <varname>instr</varname> should not make use of continuation marks (..) 
+        </note>
+        <para>
+            If the <literal>'errcatch'</literal> flag is not present, error handling works as usual.
         </para>
-        <para>Note that instr should not make use of continuation marks (..) </para>
-        <para> </para>
-        <para>If the 'errcatch' flag is not present, error handling works as usual.</para>
-        <para>If the 'errcatch' flag is set, and an error is encountered while
-            executing the instructions defined in <literal>instr</literal>, <literal>execstr</literal>
-            issues no error message, but aborts execution of the <literal>instr</literal>
+        <para>
+            If the <literal>'errcatch'</literal> flag is set, and an error is encountered while
+            executing the instructions defined in <varname>instr</varname>, <function>execstr</function>
+            issues no error message, but aborts execution of the <varname>instr</varname>
             instructions (at the point where the error occurred), and resumes with
-            <literal>ierr</literal> equal to the error number.  In this case the display of the
-            error message is controlled by the <literal>msg</literal> option:
+            <varname>ierr</varname> equal to the error number.  In this case the display of the
+            error message is controlled by the <varname>msg</varname> option:
         </para>
         <variablelist>
             <varlistentry>
                 <term>"n"</term>
                 <listitem>
                     <para>
-                        no error message is displayed, but the error message is recorded (see <literal>lasterror</literal>).  This is the default.
+                        no error message is displayed, but the error message is recorded (see <link linkend="lasterror">lasterror</link>).  This is the default.
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
-        <para> ierr=execstr(instr,'errcatch') can handle syntactical errors. This is
-            useful for evalution of instruction obtained by a query to the user.
+        <para>
+            <code>ierr = execstr(instr, 'errcatch')</code> can handle syntactical errors. This is
+            useful for evaluation of instruction obtained by a query to the user.
         </para>
     </refsection>
     <refsection>
         <title>Examples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 execstr('a=1') // sets a=1.
 execstr('1+1') // does nothing (while evstr('1+1') returns 2)
 
@@ -105,11 +110,15 @@ execstr('a=[1 2 3)','errcatch')
 lasterror(%t)
 
 // variable1 does not exist
-if execstr('variable1;','errcatch')<>0 then disp("Trigger an error"),end
+if execstr('variable1;','errcatch')<>0 then
+   disp("Trigger an error");
+else
+   disp("execstr is happy");
+end
 
 // variable2 exists ... no error is triggered by execstr
-variable2=[2,3]; 
-if execstr('variable2;','errcatch')<>0 then 
+variable2=[2,3];
+if execstr('variable2;','errcatch')<>0 then
    disp("Trigger an error");
 else
    disp("execstr is happy");
index 6460105..bcded2f 100644 (file)
@@ -8,38 +8,38 @@
         <title>Séquence d'appel</title>
         <synopsis>exec(path [,mode])
             exec(fun [,mode])
-            ierr=exec(path,'errcatch' [,mode])
-            ierr=exec(fun,'errcatch' [,mode])
+            ierr = exec(path, 'errcatch' [,mode])
+            ierr = exec(fun, 'errcatch' [,mode])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Paramètres</title>
         <variablelist>
             <varlistentry>
-                <term>path  </term>
+                <term>path</term>
                 <listitem>
-                    <para>chaîne de caractères, le chemin du script à exécuter
+                    <para>chaîne de caractères, le chemin du script à exécuter.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>mode  </term>
+                <term>mode</term>
                 <listitem>
-                    <para>entier, précisant le mode d'exécution (voir plus bas)
+                    <para>entier, précisant le mode d'exécution (voir plus bas).
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>fun  </term>
+                <term>fun</term>
                 <listitem>
-                    <para>identificateur d'une fonction scilab
+                    <para>identificateur d'une fonction scilab.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>ierr  </term>
+                <term>ierr</term>
                 <listitem>
-                    <para>entier, 0 ou numéro d'erreur 
+                    <para>entier, 0 ou numéro d'erreur.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Description</title>
         <para>
-            <literal>exec(path [,mode])</literal> exécute séquentiellement les instructions
-            Scilab contenues dans le fichier spécifié par <literal>path</literal> avec le
-            mode d'exécution optionnel <literal>mode</literal> .
+            <code>exec(path [,mode])</code> exécute séquentiellement les instructions
+            Scilab contenues dans le fichier spécifié par <varname>path</varname> avec le
+            mode d'exécution optionnel <varname>mode</varname> .
         </para>
         <para>
-            Les différentes valeurs de <literal>mode</literal> sont :
+            Les différentes valeurs de <varname>mode</varname> sont :
         </para>
         <variablelist>
             <varlistentry>
@@ -92,7 +92,7 @@
                 <term>4</term>
                 <listitem>
                     <para>pause dans l'exécution au début de chaque ligne. L'exécution
-                        reprend après un appui sur la touche entrée/return. 
+                        reprend après un appui sur la touche entrée/return.
                     </para>
                 </listitem>
             </varlistentry>
             </varlistentry>
         </variablelist>
         <para>
-            <literal>exec(fun [,mode])</literal> exécute la fonction <literal>fun</literal> comme
+            <code>exec(fun [,mode])</code> exécute la fonction <varname>fun</varname> comme
             un script : aucun argument n'est utilisé en entrée ou en sortie, et
             l'exécution se fait dans l'environnement courant (les variables
             créées dans la fonction sont conservées après l'exécution). Cette
             forme est plus efficace, car ainsi les instructions du script peuvent
-            être pré-compilées (voir comp). Cette méthode d'exécution des
+            être pré-compilées (voir <link linkend="comp">comp</link>). Cette méthode d'exécution des
             scripts permet aussi de stocker des scripts comme des fonctions dans des
-            bibliothèques. 
+            bibliothèques.
         </para>
         <para>
             Si une erreur se produit pendant l'exécution, si la chaîne de
-            caractères 'errcatch' est présente, <literal>exec</literal> ne
+            caractères <literal>'errcatch'</literal> est présente, <function>exec</function> ne
             produit pas de message d'erreur, mais stoppe l'exécution du
-            script et renvoie une valeur de <literal>ierr</literal> égale au numéro de
-            l'erreur. Si la chaîne 'errcatch' n'est pas présente,
+            script et renvoie une valeur de <varname>ierr</varname> égale au numéro de
+            l'erreur. Si la chaîne <literal>'errcatch'</literal> n'est pas présente,
             la gestion habituelle des erreurs est utilisée.
         </para>
     </refsection>
         <title>REMARQUES</title>
         <para>
             Les scripts peuvent maintenant contenir des définitions de fonctions en
-            ligne (voir fonction). 
+            ligne (voir <link linkend="function">fonction</link>).
         </para>
         <para>
-            <literal>exec</literal> prend en charge les fichiers encodés aux formats ANSI/ASCII et UTF-8.
+            <function>exec</function> prend en charge les fichiers encodés aux formats ANSI/ASCII et UTF-8.
         </para>
         <para>La longueur des lignes des fichiers est limitée à 4096 caractères.</para>
     </refsection>
     <refsection>
         <title>Exemples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 // création d'un script
 mputl('a=1;b=2',TMPDIR+'/myscript')
 
@@ -159,6 +159,7 @@ exec(foo)
 
 // a et y ont été créées dans l'environnement courant
 whos -name "a "
+whos -name "y "
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
index da1c517..2610910 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
  *
  -->
     <refsynopsisdiv>
         <title>Séquence d'appel</title>
         <synopsis>execstr(instr)
-            ierr=execstr(instr,'errcatch' [,msg])
+            ierr = execstr(instr, 'errcatch' [,msg])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
         <title>Paramètres</title>
         <variablelist>
             <varlistentry>
-                <term>instr  </term>
+                <term>instr</term>
                 <listitem>
-                    <para>vecteur de chaînes de caractères</para>
+                    <para>vecteur de chaînes de caractères.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>ierr  </term>
+                <term>ierr</term>
                 <listitem>
-                    <para>entier, 0 ou numéro de l'erreur</para>
+                    <para>entier, 0 ou numéro de l'erreur.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
@@ -41,7 +41,7 @@
                 <listitem>
                     <para>
                         chaîne de caractères (<literal>'m'</literal> ou <literal>'n'</literal>). La valeur
-                        par défaut est <literal>'n'</literal>. 
+                        par défaut est <literal>'n'</literal>.
                     </para>
                 </listitem>
             </varlistentry>
     <refsection>
         <title>Description</title>
         <para>Exécute les instructions Scilab données dans l'argument
-            <literal>instr</literal>. 
+            <varname>instr</varname>.
+        </para>
+        <note>
+            Note : les instructions <varname>instr</varname> ne doivent pas comporter de marques de suite (..).
+        </note>
+        <para>
+            Si <literal>'errcatch'</literal> n'est pas présent dans les arguments, les erreurs sont contrôlées comme d'habitude.
         </para>
-        <para>Note : les instructions ne doivent pas comporter de marques de suite (..). </para>
-        <para> </para>
-        <para>Si 'errcatch' n'est pas présent dans les arguments, les erreurs sont contrôlées comme d'habitude.</para>
-        <para>Si 'errcatch' est présent dans les arguments, et qu'une erreur est
-            rencontrée lors de l'évaluation d'un élément de <literal>instr</literal>,
-            <literal>execstr</literal> ne produit aucun message d'erreur, mais stoppe
-            l'exécution des instructions stockées dans <literal>instr</literal> (au point
-            où l'erreur s'est produite), et renvoie dans <literal>ierr</literal> le numéro
+        <para>
+            Si <literal>'errcatch'</literal> est présent dans les arguments, et qu'une erreur est
+            rencontrée lors de l'évaluation d'un élément de <varname>instr</varname>,
+            <function>execstr</function> ne produit aucun message d'erreur, mais stoppe
+            l'exécution des instructions stockées dans <varname>instr</varname> (au point
+            où l'erreur s'est produite), et renvoie dans <varname>ierr</varname> le numéro
             de l'erreur. Dans ce cas l'affichage du message d'erreur est contrôlé par
-            l'option <literal>msg</literal> : 
+            l'option <varname>msg</varname> :
         </para>
         <variablelist>
             <varlistentry>
                 <term>"n"</term>
                 <listitem>
                     <para>le message d'erreur n'est pas affiché mais il est enregistré
-                        (voir <literal>lasterror</literal>). Il s'agit du comportement par
-                        défaut. 
+                        (voir <link linkend="lasterror">lasterror</link>). Il s'agit du comportement par
+                        défaut.
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
-        <para> ierr=execstr(instr,'errcatch') peut gérer les erreurs de syntaxes. Ceci
+        <para>
+            <code>ierr = execstr(instr, 'errcatch')</code> peut gérer les erreurs de syntaxes. Ceci
             peut être utile pour évaluer les instructions obtenues par une requète à
             l'utilisateur (interface homme-machine).
         </para>
     </refsection>
     <refsection>
         <title>Exemples</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 execstr('a=1') // affecte a=1.
 
 execstr('1+1') // ne fait rien de particulier (alors que evstr('1+1') renvoie 2)
@@ -111,11 +116,15 @@ execstr('a=[1 2 3)','errcatch')
 lasterror(%t)
 
 // variable1 n'existe pas
-if execstr('variable1;','errcatch')<>0 then disp("Declenche une erreur"),end
+if execstr('variable1;','errcatch')<>0 then
+   disp("Declenche une erreur");
+else
+   disp("execstr est content");
+end
 
 // variable2 existe ... Pas d'erreur dans execstr
-variable2=[2,3]; 
-if execstr('variable2;','errcatch')<>0 then 
+variable2=[2,3];
+if execstr('variable2;','errcatch')<>0 then
    disp("Declenche une erreur");
 else
    disp("execstr est content");
index 4662173..4138e44 100644 (file)
@@ -8,8 +8,8 @@
         <title>呼び出し手順</title>
         <synopsis>exec(path [,mode])
             exec(fun [,mode])
-            ierr=exec(path,'errcatch' [,mode])
-            ierr=exec(fun,'errcatch' [,mode])
+            ierr = exec(path, 'errcatch' [,mode])
+            ierr = exec(fun, 'errcatch' [,mode])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
     <refsection>
         <title>説明</title>
         <para>
-            <literal>exec(path [,mode])</literal> は,
-            <literal>path</literal>で指定したファイルの中のオプションの
-            実行モード<literal>mode</literal> でscilab命令を逐次実行します.
+            <code>exec(path [,mode])</code> は,
+            <varname>path</varname>で指定したファイルの中のオプションの
+            実行モード<varname>mode</varname> でscilab命令を逐次実行します.
         </para>
         <para>
-            以下の <literal>mode</literal> を指定できます :
-        </para>
-        <para>
-            0 
-            : デフォルト値
-        </para>
-        <para>
-            -1 
-            : 何も出力しない
-        </para>
-        <para>
-            1 
-            : 各コマンド行を出力(エコーバック)する
-        </para>
-        <para>
-            2 
-            : プロンプト <literal>--&gt;</literal> を出力する
-        </para>
-        <para>
-            3 
-            : エコー + プロンプト
-        </para>
-        <para>
-            4 
-            : 各プロンプト出力の前に停止します. キャレッジリターンを入力すると
-            実行が再開します.
-        </para>
-        <para>
-            7 
-            : 停止 + プロンプト + エコー : デモを行う際に有用なモード.
+            以下の <varname>mode</varname> を指定できます :
         </para>
+        <variablelist>
+            <varlistentry>
+                <term>0</term>
+                <listitem>
+                    <para>
+                        デフォルト値.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>-1</term>
+                <listitem>
+                    <para>
+                        何も出力しない.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>1</term>
+                <listitem>
+                    <para>
+                        各コマンド行を出力(エコーバック)する.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>2</term>
+                <listitem>
+                    <para>
+                        プロンプト <literal>--&gt;</literal> を出力する.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>3</term>
+                <listitem>
+                    <para>
+                        エコー + プロンプト.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>4</term>
+                <listitem>
+                    <para>
+                        各プロンプト出力の前に停止します. キャレッジリターンを入力すると実行が再開します.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>7</term>
+                <listitem>
+                    <para>
+                        停止 + プロンプト + エコー : デモを行う際に有用なモード.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
         <para>
-            <literal>exec(fun [,mode])</literal> は関数
-            <literal>fun</literal> をスクリプトとして実行します: 
+            <code>exec(fun [,mode])</code> は関数
+            <varname>fun</varname> をスクリプトとして実行します:
             入出力の引数も特定の変数環境もありません.
-            スクリプトコードはプリコンパイル(comp参照)されるため,
+            スクリプトコードはプリコンパイル(<link linkend="comp">comp</link>参照)されるため,
             この形式は最も効率的です.
             スクリプト評価のこの方法により,スクリプトをライブラリの
             関数として保持することが可能になります.
         </para>
         <para>実行時にエラーが発生し,
-            'errcatch'フラグが指定されている場合,
-            <literal>exec</literal>はエラーメッセージを出力せずに
-            命令を実行を破棄し,エラー番号を<literal>ierr</literal>に
+            <literal>'errcatch'</literal>フラグが指定されている場合,
+            <function>exec</function>はエラーメッセージを出力せずに
+            命令を実行を破棄し,エラー番号を<varname>ierr</varname>に
             代入して復帰します.
-            'errcatch' フラグが存在しない場合,標準のエラー処理が
+            <literal>'errcatch'</literal> フラグが存在しない場合,標準のエラー処理が
             機能します.
         </para>
     </refsection>
     <refsection>
         <title>注意k</title>
         <para>
-            <literal>exec</literal> ファイルは,
+            <function>exec</function> ファイルは,
             インライン関数定義構文(関数の項参照)により関数を定義する際に使用されます.
         </para>
     </refsection>
     <refsection>
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 // スクリプトファイルを作成
 mputl('a=1;b=2',TMPDIR+'/myscript')
 
@@ -129,6 +158,7 @@ exec(foo)
 
 // カレントの環境にa と y が作成されました
 whos -name "a "
+whos -name "y "
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
index 86da2bd..e323109 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
  *
  -->
@@ -18,7 +18,7 @@
     <refsynopsisdiv>
         <title>呼び出し手順</title>
         <synopsis>execstr(instr)
-            ierr=execstr(instr,'errcatch' [,msg])
+            ierr = execstr(instr, 'errcatch' [,msg])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
     <refsection>
         <title>説明</title>
         <para>
-            引数<literal>instr</literal>で指定したScilab命令を実行します.
+            引数<varname>instr</varname>で指定したScilab命令を実行します.
         </para>
-        <para>
-            instr の中では継続記号 (..) を使用する必要は
+        <note>
+            <varname>instr</varname>の中では継続記号 (..) を使用する必要は
             ないことに注意してください.
-        </para>
-        <para> </para>
+        </note>
         <para>
-            'errcatch'フラグが指定されない場合,
+            <literal>'errcatch'</literal>フラグが指定されない場合,
             エラー処理は通常と同様に行われます.
         </para>
         <para>
-            'errcatch'フラグが指定された場合,
-            <literal>instr</literal>で定義された命令を実行す際に
+            <literal>'errcatch'</literal>フラグが指定された場合,
+            <varname>instr</varname>で定義された命令を実行す際に
             発生したエラーはエラーメッセージを発生せず,
-            <literal>instr</literal> 命令の実行を
+            <varname>instr</varname> 命令の実行を
             (エラーが発生した場所で)破棄し,
-            エラー番号に等しい<literal>ierr</literal>を返して
+            エラー番号に等しい<varname>ierr</varname>を返して
             復帰します.
             この場合,エラーメッセージの出力は
-            <literal>msg</literal>オプションにより次のように
+            <varname>msg</varname>オプションにより次のように
             制御されます:
         </para>
         <variablelist>
                 <listitem>
                     <para>
                         エラーメッセージは表示されませんが,
-                        記録されます ( <literal>lasterror</literal>参照).  
+                        記録されます ( <link linkend="lasterror">lasterror</link>参照).
                         これがデフォルトです.
                     </para>
                 </listitem>
             </varlistentry>
         </variablelist>
-        <para> ierr=execstr(instr,'errcatch') は構文エラーも
+        <para>
+            <code>ierr = execstr(instr, 'errcatch')</code> は構文エラーも
             処理することができます.
             この特徴は,ユーザへの問い合わせにより得られた命令を
             評価する際に有用です.
     </refsection>
     <refsection>
         <title>例</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 execstr('a=1') // sets a=1.
 execstr('1+1') // does nothing (while evstr('1+1') returns 2)
 
@@ -122,11 +122,15 @@ execstr('a=[1 2 3)','errcatch')
 lasterror(%t)
 
 // variable1 does not exist
-if execstr('variable1;','errcatch')<>0 then disp("Trigger an error"),end
+if execstr('variable1;','errcatch')<>0 then
+   disp("Trigger an error");
+else
+   disp("execstr is happy");
+end
 
 // variable2 exists ... no error is triggered by execstr
-variable2=[2,3]; 
-if execstr('variable2;','errcatch')<>0 then 
+variable2=[2,3];
+if execstr('variable2;','errcatch')<>0 then
    disp("Trigger an error");
 else
    disp("execstr is happy");
index 258d610..47c0040 100644 (file)
@@ -1,5 +1,5 @@
 <?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: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="exec" 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: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="exec" xml:lang="pt">
     <refnamediv>
         <refname>exec</refname>
         <refpurpose>execução de arquivo script ("script" significa
@@ -10,8 +10,8 @@
         <title>Seqüência de Chamamento</title>
         <synopsis>exec(path [,mode])
             exec(fun [,mode])
-            ierr=exec(path,'errcatch' [,mode])
-            ierr=exec(fun,'errcatch' [,mode])
+            ierr = exec(path,'errcatch' [,mode])
+            ierr = exec(fun,'errcatch' [,mode])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
     <refsection>
         <title>Descrição</title>
         <para>
-            <literal>exec(path [,mode])</literal> executa seqüencialmente as
-            instruções contidas no arquivo fornecido por <literal>path</literal> com
-            um modo de execução opcional <literal>mode</literal> .
+            <code>exec(path [,mode])</code> executa seqüencialmente as
+            instruções contidas no arquivo fornecido por <varname>path</varname> com
+            um modo de execução opcional <varname>mode</varname> .
         </para>
         <para>
-            Os casos diferentes para <literal>mode</literal> são :
+            Os casos diferentes para <varname>mode</varname> são :
         </para>
-        <para>0 : o valor padrão</para>
-        <para>-1 : nada é impresso</para>
-        <para>1 : eco de cada linha de comando</para>
-        <para>2 : prompt --&gt; é impresso</para>
-        <para>3 : ecos + prompts</para>
-        <para>4 : pára antes de cada prompt. A execução retorna após cada retorno
-            de carro.
-        </para>
-        <para>7 : paradas + prompts + ecos : útil para demos.</para>
+        <variablelist>
+            <varlistentry>
+                <term>0</term>
+                <listitem>
+                    <para>
+                        o valor padrão.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>-1</term>
+                <listitem>
+                    <para>
+                        nada é impresso.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>1</term>
+                <listitem>
+                    <para>
+                        eco de cada linha de comando.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>2</term>
+                <listitem>
+                    <para>
+                        prompt <literal>--&gt;</literal> é impresso.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>3</term>
+                <listitem>
+                    <para>
+                        ecos + prompts.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>4</term>
+                <listitem>
+                    <para>
+                        pára antes de cada prompt. A execução retorna
+                        após cada retorno de carro.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>7</term>
+                <listitem>
+                    <para>
+                        paradas + prompts + ecos : útil para demos.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
         <para>
-            <literal>exec(fun [,mode])</literal> executa a função
-            <literal>fun</literal> como um script: sem argumentos de entrada ou saída
+            <code>exec(fun [,mode])</code> executa a função
+            <varname>fun</varname> como um script: sem argumentos de entrada ou saída
             nem ambientes de variáveis específicos. Esta forma é mais eficiente,
-            porque o código script pode se pré-compilado (ver comp). Este método
+            porque o código script pode se pré-compilado (ver <link linkend="comp">comp</link>). Este método
             para avaliação de scripts permite armazenar scripts como funções em
             bibliotecas.
         </para>
-        <para>Se um erro é encontrado durante a execução, se o flag 'errcatch'
-            estiver presente <literal>exec</literal> não imprime mensagem de erro,
-            aborta execução de instruções e retorna com <literal>ierr</literal> e
-            igual ao número de erro. Se o flag 'errcatch' não estiver presente, a
+        <para>
+            Se um erro é encontrado durante a execução, se o flag <literal>'errcatch'</literal>
+            estiver presente <function>exec</function> não imprime mensagem de erro,
+            aborta execução de instruções e retorna com <varname>ierr</varname> e
+            igual ao número de erro. Se o flag <literal>'errcatch'</literal> não estiver presente, a
             manipulação de erros padrão é utilizada.
         </para>
     </refsection>
         <title>Observação </title>
         <para>Arquivos executáveis (exec files) podem agora ser usados para
             definir funções "inline" utilizando a sintaxe de definição (ver
-            function).
+            <link linkend="function">function</link>).
         </para>
     </refsection>
     <!--
-    <para><literal>exec</literal> supports files encoded as ANSI/ASCII and UTF-8 (NO-BOM).</para>
- -->
+    <para><function>exec</function> supports files encoded as ANSI/ASCII and UTF-8 (NO-BOM).</para>
+    <para>The length of each line in a file is limited to 4096 characters.</para>
+-->
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 // criando um arquivo script
 mputl('a=1;b=2',TMPDIR+'/meuscript')
 // executando-o
@@ -109,6 +161,7 @@ x=1 //criando x para torná-la conhecida pelo script foo
 exec(foo)
 // a e y são criadas no ambiente corrente
 whos -name "a "
+whos -name "y "
  ]]></programlisting>
     </refsection>
     <refsection>
index 1c02d06..746efa9 100644 (file)
@@ -2,15 +2,15 @@
 <!--
  * 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: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="execstr" 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="execstr" xml:lang="pt">
     <refnamediv>
         <refname>execstr</refname>
         <refpurpose>executa código Scilab em strings</refpurpose>
@@ -18,7 +18,7 @@
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
         <synopsis>execstr(instr)
-            ierr=execstr(instr,'errcatch' [,msg])
+            ierr = execstr(instr, 'errcatch' [,msg])
         </synopsis>
     </refsynopsisdiv>
     <refsection>
     <refsection>
         <title>Descrição</title>
         <para>Executa as instruções Scilab fornecidas pelo argumento
-            <literal>instr</literal>.
-        </para>
-        <para>Note que instr não deve fazer uso de marcas de continuação(..)
+            <varname>instr</varname>.
         </para>
-        <para/>
-        <para>Se o flag 'errcatch' não estiver presente, a manipulação de erros
+        <note>
+            Note que <varname>instr</varname> não deve fazer uso de marcas de continuação (..)
+        </note>
+        <para>
+            Se o flag <literal>'errcatch'</literal> não estiver presente, a manipulação de erros
             ocorre de maneira usual.
         </para>
-        <para>Se o flag 'errcatch' for ajustado, e um erro for encontrado enquanto
-            são executadas as instruções definidas em <literal>instr</literal>,
-            <literal>execstr</literal> não imprime uma mensagem de erro, mas aborta a
-            execução das instruções <literal>instr</literal> (no ponto onde o erro
-            ocorreu) e retorna com <literal>ierr</literal> igual ao número de erro.
+        <para>
+            Se o flag <literal>'errcatch'</literal> for ajustado, e um erro for encontrado enquanto
+            são executadas as instruções definidas em <varname>instr</varname>,
+            <function>execstr</function> não imprime uma mensagem de erro, mas aborta a
+            execução das instruções <varname>instr</varname> (no ponto onde o erro
+            ocorreu) e retorna com <varname>ierr</varname> igual ao número de erro.
             Neste caso a exibição da mensagem de erro é controlada pela opção
-            <literal>msg</literal> :
+            <varname>msg</varname> :
         </para>
         <variablelist>
             <varlistentry>
                 </listitem>
             </varlistentry>
         </variablelist>
-        <para>ierr= execstr(instr,'errcatch') pode manipular erros sintáticos.
+        <para>
+            <code>ierr = execstr(instr, 'errcatch')</code> pode manipular erros sintáticos.
             Isto é útil para a avaliação de uma instrução obtida por uma pegunta ao
             usuário.
         </para>
     </refsection>
     <refsection>
         <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[ 
+        <programlisting role="example"><![CDATA[
 execstr('a=1') // ajusta a=1.
 execstr('1+1') // faz nada (enquanto evstr('1+1') retorna 2)
 
@@ -110,6 +113,21 @@ lasterror(%t)
 
 execstr('a=[1 2 3)','errcatch')
 lasterror(%t)
+
+// variable1 does not exist
+if execstr('variable1;','errcatch')<>0 then
+   disp("Trigger an error");
+else
+   disp("execstr is happy");
+end
+
+// variable2 exists ... no error is triggered by execstr
+variable2=[2,3];
+if execstr('variable2;','errcatch')<>0 then
+   disp("Trigger an error");
+else
+   disp("execstr is happy");
+end
  ]]></programlisting>
     </refsection>
     <refsection role="see also">
diff --git a/scilab/modules/functions/help/ru_RU/exec.xml b/scilab/modules/functions/help/ru_RU/exec.xml
new file mode 100644 (file)
index 0000000..753e920
--- /dev/null
@@ -0,0 +1,191 @@
+<?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="exec">
+    <refnamediv>
+        <refname>exec</refname>
+        <refpurpose>исполнение файла-сценария</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>exec(path [,mode])
+            exec(fun [,mode])
+            ierr = exec(path, 'errcatch' [,mode])
+            ierr = exec(fun, 'errcatch' [,mode])
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>path</term>
+                <listitem>
+                    <para>
+                        строка, путь к файлу-сценарию.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>mode</term>
+                <listitem>
+                    <para>
+                        целочисленный скаляр, режим исполнения (см. ниже).
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>fun</term>
+                <listitem>
+                    <para>Scilab-функция.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>ierr</term>
+                <listitem>
+                    <para>целое число, 0 либо номер ошибки.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            <code>exec(path [,mode])</code> исполняет последовательно
+            Scilab-инструкции, содержащиеся в файле, указанном в пути
+            <varname>path</varname>, в режиме исполнения, указанным
+            необязательным аргументом <varname>mode</varname>.
+        </para>
+        <para>
+            Режим исполнения <varname>mode</varname> имеет следующие
+            значения:
+        </para>
+        <variablelist>
+            <varlistentry>
+                <term>0</term>
+                <listitem>
+                    <para>
+                        значение по умолчанию.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>-1</term>
+                <listitem>
+                    <para>
+                        вывод на экран не производится.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>1</term>
+                <listitem>
+                    <para>
+                        отображает каждую командную строку.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>2</term>
+                <listitem>
+                    <para>
+                        на экран выводится строка приглашения <literal>--&gt;</literal>.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>3</term>
+                <listitem>
+                    <para>
+                        отображения командных строк + строки приглашения.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>4</term>
+                <listitem>
+                    <para>
+                        останавливается перед каждой строкой
+                        приглашения. Исполнение возобновляется после
+                        возврата каретки.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>7</term>
+                <listitem>
+                    <para>
+                        остановки + строки приглашения + вывод на экран командных строк: режим, полезный для демонстраций.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+        <para>
+            <code>exec(fun [,mode])</code> исполняет функцию <varname>fun</varname> как файл-сценарий: ни входного, ни выходного аргумента, ни особого окружения переменных. Эта форма более эффективна, поскольку код сценария может быть предварительно скомпилирован (см. <link linkend="comp">comp</link>). Этот метод исполнения сценария позволяет хранить сценарии в виде функций в библиотеках.
+        </para>
+        <para>
+            Если во время исполнения произойдёт ошибка, и если будет
+            указан флаг <literal>'errcatch'</literal>, то  функция
+            <function>exec</function> не будет выдавать сообщения об
+            ошибке, прервёт исполнение инструкций и вернёт номер ошибки
+            <varname>ierr</varname>. Если же флаг
+            <literal>'errcatch'</literal> не будет указан, то будет
+            работать стандартная обработка ошибок.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примечания</title>
+        <para>
+            Теперь файлы для функции <function>exec</function> можно использовать для определения функций, используя синтаксис определения функции в строке (см. <link linkend="function">function</link>).
+        </para>
+        <para>
+            Функция <function>exec</function> поддерживает файлы с кодировкаой ANSI/ASCII и UTF-8.
+        </para>
+        <para>
+            Длина каждой строки в файле ограничена 4096 символами.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+// создадим файл-сценарий
+mputl('a=1;b=2',TMPDIR+'/myscript')
+// выполним его
+exec(TMPDIR+'/myscript')
+whos -name "a "
+// создадим функцию
+deff('y=foo(x)','a=x+1;y=a^2')
+clear a b
+// вызовем функцию
+foo(1)
+// a - переменная, созданная в окружении функции foo;
+// она будет уничтожена после возврата из foo
+whos -name "a "
+x=1 //создадим x чтобы его узнал сценарий foo
+exec(foo)
+// a и y созданы в текущем окружении
+whos -name "a "
+whos -name "y "
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="execstr">execstr</link>
+            </member>
+            <member>
+                <link linkend="evstr">evstr</link>
+            </member>
+            <member>
+                <link linkend="comp">comp</link>
+            </member>
+            <member>
+                <link linkend="mode">mode</link>
+            </member>
+            <member>
+                <link linkend="chdir">chdir</link>
+            </member>
+            <member>
+                <link linkend="pwd">pwd</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>
diff --git a/scilab/modules/functions/help/ru_RU/execstr.xml b/scilab/modules/functions/help/ru_RU/execstr.xml
new file mode 100644 (file)
index 0000000..41ddab2
--- /dev/null
@@ -0,0 +1,153 @@
+<?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="execstr">
+    <refnamediv>
+        <refname>execstr</refname>
+        <refpurpose>
+            исполняет Scilab-код, заданный в строках
+        </refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>Последовательность вызова</title>
+        <synopsis>
+            execstr(instr)
+            ierr = execstr(instr,'errcatch' [,msg])
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>instr</term>
+                <listitem>
+                    <para>
+                        вектор символьных строк, Scilab-инструкции, которые нужно исполнить.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>ierr</term>
+                <listitem>
+                    <para>
+                        целое число, 0 или номер ошибки.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>msg</term>
+                <listitem>
+                    <para>
+                        символьная строка со значениями <literal>'m'</literal> или <literal>'n'</literal>.  Значение по умолчанию -  <literal>'n'</literal>.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            Исполняет Scilab-инструкции, указанные в аргументе
+            <varname>instr</varname>.
+        </para>
+        <note>
+            Заметьте, что инструкции <varname>instr</varname> не должны использовать символы продолжения (..)
+        </note>
+        <para>
+            Если флаг <literal>'errcatch'</literal> не указан, то обработка ошибок ведётся как обычно.
+        </para>
+        <para>
+            Если указан флаг <literal>'errcatch'</literal>, и во время исполнения инструкций в <varname>instr</varname> произойдёт ошибка,то функция <function>execstr</function> не выдасть сообщения об ошибке, но прекратит исполнение инструкций <varname>instr</varname> (в том месте, где произошла ошибка), и вернёт номер ошибки <varname>ierr</varname>. В этом случае отображение ошибки управляется опцией <varname>msg</varname>:
+        </para>
+        <variablelist>
+            <varlistentry>
+                <term>"m"</term>
+                <listitem>
+                    <para>
+                        сообщение об ошибке отображение и записывается.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>"n"</term>
+                <listitem>
+                    <para>
+                        сообщиение об ошибке не отображается, однако записывается (see <link linkend="lasterror">lasterror</link>). Это значение по умолчанию.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+        <para>
+            <code>ierr = execstr(instr, 'errcatch')</code> может
+            обрабатывать синтаксические ошибки. Это полезно для
+            выполнения инструкций, полученных по запросу пользователя.
+        </para>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[
+execstr('a=1') // устанавливает a=1.
+
+execstr('1+1') // ничего не делает (тогда как evstr('1+1') возвращает 2)
+
+execstr(['if %t then';
+         '  a=1';
+         '  b=a+1';
+         'else'
+         ' b=0'
+         'end'])
+
+execstr('a=zzzzzzz','errcatch')
+
+execstr('a=zzzzzzz','errcatch','m')
+
+//syntax errors
+execstr('a=1?02','errcatch')
+lasterror(%t)
+
+execstr('a=[1 2 3)','errcatch')
+lasterror(%t)
+
+// variable1 не существует
+if execstr('variable1;','errcatch')<>0 then
+   disp("Взведена ошибка");
+else
+   disp("execstr полна счастья");
+end
+
+// variable2 существует ... execstr не взводит ошибки
+variable2=[2,3];
+if execstr('variable2;','errcatch')<>0 then
+   disp("Взведена ошибка");
+else
+   disp("execstr полна счастья");
+end
+ ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="evstr">evstr</link>
+            </member>
+            <member>
+                <link linkend="lasterror">lasterror</link>
+            </member>
+            <member>
+                <link linkend="error">error</link>
+            </member>
+            <member>
+                <link linkend="try">try</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>