* Bug 13855 fixed [doc]: pause() page updated & improved 33/21633/5
Samuel GOUGEON [Sat, 5 Dec 2020 15:47:01 +0000 (16:47 +0100)]
  http://bugzilla.scilab.org/13855
  New en_US page: http://bugzilla.scilab.org/attachment.cgi?id=5192 (PDF)

Change-Id: Ib7e11d938ba9629edc54df4cff2bfd331e9f3745

scilab/CHANGES.md
scilab/modules/core/help/en_US/2_control_flow/pause.xml
scilab/modules/core/help/fr_FR/2_control_flow/pause.xml
scilab/modules/core/help/ja_JP/2_control_flow/pause.xml
scilab/modules/core/help/pt_BR/2_control_flow/pause.xml
scilab/modules/core/help/ru_RU/2_control_flow/pause.xml

index 9e8c116..41ea73a 100644 (file)
@@ -326,6 +326,7 @@ Bug Fixes
 * [#13417](https://bugzilla.scilab.org/13417): `csvRead` page did not document the way to use the `range` up to the last row/column.
 * [#13593](https://bugzilla.scilab.org/13593): `csvRead()` did not take the `range` into account when `header` is provided. `[]` could not be used as default `range`.
 * [#13762](https://bugzilla.scilab.org/13762): In the `fft` page, the formula for the inverse FFT missed the 1/n normalization factor.
+* [#13855](https://bugzilla.scilab.org/13855): The documentation of `pause` was not up-to-date and could be improved.
 * [#13985](https://bugzilla.scilab.org/13985): The display of lists was very loose and poor.
 * [#14033](https://bugzilla.scilab.org/14033): `x_matrix` could not edit matrices of booleans, encoded integers or text. Matrices of real or complex numbers were poorly displayed.
 * [#14435](https://bugzilla.scilab.org/14435): Errors were not well handled in overloaded functions.
index 5883a24..8abf7c9 100644 (file)
@@ -1,8 +1,27 @@
 <?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="en" xml:id="pause">
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2006 - 2008 - INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<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="pause">
     <refnamediv>
         <refname>pause</refname>
-        <refpurpose>pause mode, invoke keyboard</refpurpose>
+        <refpurpose>
+            temporarily pauses the running execution, and allows instructions in console.
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
     <refsection>
         <title>Description</title>
         <para>
-            Switch to the <code>pause</code> mode;
-            inserted in the code of a function, <code>pause</code> interrupts the execution
+            Switch to the <function>pause</function> mode.
+            Inserted in the code of a function, <function>pause</function> interrupts the execution
             of the function: one receives a prompt symbol which indicates
-            the level of the <code>pause</code> (e.g. <literal>-1-&gt;</literal>). The user is
-            then in a new workspace in which all the lower-level variables
-            (and in particular all the variable of the function) are available.
-            To return to the calling workspace enter <code>return</code>.
+            the level of the <function>pause</function> (e.g. <literal>-1-&gt;</literal>).
+            The user is then in the workspace where the pause occurs, and where all the variables
+            around are accessible and can be changed by hand on purpose.
         </para>
         <para>
-            In this mode, <literal>[...]=return(...) </literal>
-            returns the variables of the argument <literal>(...)</literal> to the calling workspace with
-            names in the output <literal>[...]</literal>. Otherwise, the lower-level variables
-            are protected and cannot be modified.
+            To resume the execution, enter <code>resume</code>.
         </para>
         <para>
-            The <literal>pause</literal> is extremely useful for debugging purposes.
-        </para>
-        <para>
-            This mode is killed by the command <code>abort</code>.
+            Enter <code>abort</code> to definitively stop the execution and return to the main level.
         </para>
+        <note>
+            The <function>pause</function> is very useful for debugging purposes.
+        </note>
     </refsection>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
-    function c=foo(b)
-    a=42+b
+function c = foo(b)
+    a = 42 + b
     disp("Thanks to the pause, you can investigate if ''a'' has the right value");
-    disp("Value can be changed too if needed.");
+    disp("Values of local variables can be changed too if required.");
     pause
-    c=a+2
-    endfunction
+    c = a + 2
+endfunction
+
+a = 3;
+foo(2)
+     ]]></programlisting>
+        <screen><![CDATA[
+--> a = 3;
+--> foo(2)
+  "Thanks to the pause, you can investigate if 'a' has the right value"
+  "Values of local variables can be changed too if required."
+
+Type 'resume' or 'abort' to return to standard level prompt.
 
-    foo(2)
- ]]></programlisting>
+-1-> a
+ a  =
+   44.
+
+-1-> a = 0;
+
+-1-> resume
+ ans  =
+   2.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>See also</title>
         <simplelist type="inline">
             <member>
+                <link linkend="debug">debug</link>
+            </member>
+            <member>
                 <link linkend="halt">halt</link>
             </member>
             <member>
                 <link linkend="abort">abort</link>
             </member>
             <member>
-                <link linkend="quit">quit</link>
-            </member>
-            <member>
                 <link linkend="whereami">whereami</link>
             </member>
             <member>
-                <link linkend="where">where</link>
+                <link linkend="sleep">sleep</link>
             </member>
             <member>
-                <link linkend="sleep">sleep</link>
+                <link linkend="quit">quit</link>
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revdescription>
+                    The new values of local variables changed during a pause are now taken
+                    into account when resuming the execution with <literal>resume</literal>.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 6ea994d..5b8d029 100644 (file)
@@ -1,8 +1,27 @@
 <?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="fr" xml:id="pause">
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2006-2008 - INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<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="pause">
     <refnamediv>
         <refname>pause</refname>
-        <refpurpose>mode de pause, attente clavier  </refpurpose>
+        <refpurpose>
+            suspend temporairement l'exécution en cours, et autorise les commandes en console
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntaxe</title>
     <refsection>
         <title>Description</title>
         <para>
-            Passage en mode de <literal>pause</literal>;
-            inséré dans le code d'une fonction, <literal>pause</literal> fait une pause dans l'exécution
-            de la fonction : un symbole d'invite de commande est affiché à l'utilisateur indiquant le "niveau" de la <literal>pause</literal> (e.g. <literal>-1-&gt;</literal>). L'utilisateur se trouve dans un environnement dans lequel toutes les variables du niveau correspondant sont accessibles (en particulier les variables locales de la fonction).
-            Pour reprendre l'exécution taper <literal>"return"</literal>.
+            Passage en mode de <function>pause</function>.
+            Inséré dans le code d'une fonction, <function>pause</function> interrompt momentanément
+            l'exécution de la fonction et donne la main à l'utilisateur dans la console Scilab.
+            Une invite de commande spécifique <literal>-#-></literal> est affichée, où # est
+            la profondeur d'exécution à laquelle la pause se trouve (e.g. <literal>-1-&gt;</literal>).
+            L'utilisateur se trouve dans un environnement dans lequel toutes les variables du niveau
+            correspondant sont accessibles (en particulier les variables locales de la fonction)
+            et peuvent si besoin être modifiées.
         </para>
         <para>
-            Dans ce mode, <literal>[...]=return(...) </literal>
-            renvoie les variables de l'argument <literal>(...)</literal> dans l'environnement appelant
-            sous les noms précisés dans <literal> [...]</literal>. Sinon, les variables de l'environnement interrompu sont protégées et non modifiables.
+            Pour reprendre et poursuivre l'exécution, taper <literal>resume</literal>.
         </para>
         <para>
-            L'instruction <literal>pause</literal> est très utile en phase de mise au point ou de débogage.
-        </para>
-        <para>
-            Il est possible de sortir du mode de pause en mettant fin à l'exécution en tapant <literal>"abort"</literal>.
+            Pour sortir du mode pause et mettre fin à l'exécution, taper <literal>abort</literal>.
         </para>
+        <note>
+            L'instruction <function>pause</function> est très utile en phase de mise au point ou
+            de débogage.
+        </note>
+    </refsection>
+    <refsection>
+        <title>Exemples</title>
+        <programlisting role="example"><![CDATA[
+function c = foo(b)
+    a = 42 + b
+    disp("En mode pause, la valeur courante de ''a'' peut être vérifiée.");
+    disp("La valeur des variables internes locales peuvent si besoin être modifiées.");
+    pause
+    c = a + 2
+endfunction
+
+a = 3;
+foo(2)
+     ]]></programlisting>
+        <screen><![CDATA[
+--> a = 3;
+--> foo(2)
+  "En mode pause, la valeur courante de 'a' peut être vérifiée."
+  "La valeur des variables internes locales peuvent si besoin être modifiées."
+
+Type 'resume' or 'abort' to return to standard level prompt.
+
+-1-> a
+ a  =
+   44.
+
+-1-> a = 0;
+
+-1-> resume
+ ans  =
+   2.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>Voir aussi</title>
         <simplelist type="inline">
             <member>
+                <link linkend="debug">debug</link>
+            </member>
+            <member>
                 <link linkend="halt">halt</link>
             </member>
             <member>
                 <link linkend="abort">abort</link>
             </member>
             <member>
-                <link linkend="quit">quit</link>
-            </member>
-            <member>
                 <link linkend="whereami">whereami</link>
             </member>
             <member>
-                <link linkend="where">where</link>
+                <link linkend="sleep">sleep</link>
             </member>
             <member>
-                <link linkend="sleep">sleep</link>
+                <link linkend="quit">quit</link>
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>Historique</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revdescription>
+                    Les nouvelles valeurs des variables locales modifiées durant une pause sont
+                    désormais prises en compte lorsque l'exécution du code restant est relancée
+                    avec <literal>resume</literal>.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index a734ee8..62148a3 100644 (file)
@@ -1,8 +1,27 @@
 <?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="ja" xml:id="pause">
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2006-2008 - INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<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="ja" xml:id="pause">
     <refnamediv>
         <refname>pause</refname>
-        <refpurpose>中断モード, キーボード入力を待つ</refpurpose>
+        <refpurpose>
+            は実行中の実行を一時的に一時停止し、コンソールでの指示を許可します
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼出し手順</title>
     <refsection>
         <title>説明</title>
         <para>
-            <code>pause</code>モードに切り替えます;
-            関数のコードに挿入すると,<code>pause</code>は関数の実行を中断し,
-            <code>pause</code>のレベル (例: <literal>-1-&gt;</literal>)を
+            <function>pause</function>モードに切り替えます;
+            関数のコードに挿入すると,<function>pause</function>は関数の実行を中断し,
+            <function>pause</function>のレベル (例: <literal>-1-&gt;</literal>)を
             示すプロンプト記号が表示がされます.
             この時,ユーザは新しいワークスペースにおり,
-            より低いレベルの変数(特にその関数内の全ての変数)が全て利用可能となっています.
-            コールしたワークスペースに戻るには<code>return</code>を入力します.
+            より低いレベルの変数(特にその関数内の全ての変数)が全て利用可能となっています 意図的に変更できます.
         </para>
         <para>
-            このモードでは, <literal>[...]=return(...) </literal>は
-            引数の変数 <literal>(...)</literal> をコールしたワークスペースに
-            <literal> [...]</literal>という名前の出力として返します.
-            一方, より低いレベルの変数は保護され, 修正することはできません.
+            To resume the execution, enter <code>resume</code>.
         </para>
         <para>
-            <literal>pause</literal> はデバッグの際に非常に有用です.
-        </para>
-        <para>
-            このモードはコマンド <literal>"abort"</literal>により破棄することができます.
+            このモードはコマンド <literal>abort</literal>により破棄することができます.
         </para>
+        <note>
+            <function>pause</function> はデバッグの際に非常に有用です.
+        </note>
     </refsection>
     <refsection>
         <title>例</title>
         <programlisting role="example"><![CDATA[
-    function c=foo(b)
-    a=42+b
+function c = foo(b)
+    a = 42 + b
     disp("Thanks to the pause, you can investigate if ''a'' has the right value");
-    disp("Value can be changed too if needed.");
+    disp("Values of local variables can be changed too if required.");
     pause
-    c=a+2
-    endfunction
+    c = a + 2
+endfunction
+
+a = 3;
+foo(2)
+     ]]></programlisting>
+        <screen><![CDATA[
+--> a = 3;
+--> foo(2)
+  "Thanks to the pause, you can investigate if 'a' has the right value"
+  "Values of local variables can be changed too if required."
+
+Type 'resume' or 'abort' to return to standard level prompt.
 
-    foo(2)
- ]]></programlisting>
+-1-> a
+ a  = 
+   44.
+
+-1-> a = 0;
+
+-1-> resume
+ ans  =
+   2.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>参照</title>
         <simplelist type="inline">
             <member>
+                <link linkend="debug">debug</link>
+            </member>
+            <member>
                 <link linkend="halt">halt</link>
             </member>
             <member>
                 <link linkend="abort">abort</link>
             </member>
             <member>
-                <link linkend="quit">quit</link>
-            </member>
-            <member>
                 <link linkend="whereami">whereami</link>
             </member>
             <member>
-                <link linkend="where">where</link>
+                <link linkend="sleep">sleep</link>
             </member>
             <member>
-                <link linkend="sleep">sleep</link>
+                <link linkend="quit">quit</link>
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revdescription>
+                    The new values of local variables changed during a pause are now taken
+                    into account when resuming the execution with <literal>resume</literal>.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index 70a91db..c68b1bf 100644 (file)
@@ -1,8 +1,27 @@
 <?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: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="pause" xml:lang="pt">
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2006-2008 - INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<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="pause" xml:lang="pt">
     <refnamediv>
         <refname>pause</refname>
-        <refpurpose>modo de pausa, invoca teclado</refpurpose>
+        <refpurpose>
+            pausa temporariamente a execução atual e permite instruções no console.
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Seqüência de Chamamento</title>
     <refsection>
         <title>Descrição</title>
         <para>
-            Alterna para o modo <literal>pause</literal> ; inserido no código de
-            uma função, <literal>pause</literal> interrompe a execução da mesma:
+            Alterna para o modo <function>pause</function> ; inserido no código de
+            uma função, <function>pause</function> interrompe a execução da mesma:
             recebe-se um símbolo de prompt para indicar o nível de
-            <literal>pause</literal> (exemplo: <literal>-1-&gt;</literal>). O usuário
+            <function>pause</function> (exemplo: <literal>-1-&gt;</literal>). O usuário
             está agora num novo espaço de trabalho em que todas as variáveis de nível
-            infeiror (em particular todas as variáveis da função) estão disponíveis.
-            Para retornar ao espaço de trabalho de chamamento, entre
-            <literal>"return"</literal>
+            infeiror (em particular todas as variáveis da função) estão disponíveis
+            e podem ser alteradas propositalmente.
         </para>
         <para>
-            Neste modo, <literal>[...]=return(...) </literal> retorna as
-            variáveis dos argumentos <literal>(...)</literal> ao espaço de trabalho de
-            chamamento com nomes na saída<literal> [...]</literal>. Em caso contrário,
-            as variáveis de nível infeiror são protegidas e não podem ser
-            modificadas.
+            Para retomar e continuar a execução, entre <literal>resume</literal>.
         </para>
         <para>
-            <literal>pause</literal> é extremamente útil para propósitos de
-            depuramento.
-        </para>
-        <para>Este modo pode ser cancelado pelo comando
-            <literal>"abort"</literal>.
+            Este modo pode ser cancelado pelo comando <literal>abort</literal>.
         </para>
+        <note>
+            <function>pause</function> é extremamente útil para propósitos de depuramento.
+        </note>
+    </refsection>
+    <refsection>
+        <title>Exemplos</title>
+        <programlisting role="example"><![CDATA[
+function c = foo(b)
+    a = 42 + b
+    disp("Thanks to the pause, you can investigate if ''a'' has the right value");
+    disp("Values of local variables can be changed too if required.");
+    pause
+    c = a + 2
+endfunction
+
+a = 3;
+foo(2)
+     ]]></programlisting>
+        <screen><![CDATA[
+--> a = 3;
+--> foo(2)
+  "Thanks to the pause, you can investigate if 'a' has the right value"
+  "Values of local variables can be changed too if required."
+
+Type 'resume' or 'abort' to return to standard level prompt.
+
+-1-> a
+ a  =
+   44.
+
+-1-> a = 0;
+
+-1-> resume
+ ans  =
+   2.
+]]></screen>
     </refsection>
     <refsection>
         <title> Ver Também </title>
         <simplelist type="inline">
             <member>
+                <link linkend="debug">debug</link>
+            </member>
+            <member>
                 <link linkend="halt">halt</link>
             </member>
             <member>
                 <link linkend="abort">abort</link>
             </member>
             <member>
-                <link linkend="quit">quit</link>
-            </member>
-            <member>
                 <link linkend="whereami">whereami</link>
             </member>
             <member>
-                <link linkend="where">where</link>
+                <link linkend="sleep">sleep</link>
             </member>
             <member>
-                <link linkend="sleep">sleep</link>
+                <link linkend="quit">quit</link>
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>Histórico</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revdescription>
+                    The new values of local variables changed during a pause are now taken
+                    into account when resuming the execution with <literal>resume</literal>.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index db7992c..572f915 100644 (file)
@@ -1,8 +1,27 @@
 <?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="pause">
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2006-2008 - INRIA
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2020 - Samuel GOUGEON
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<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="pause">
     <refnamediv>
         <refname>pause</refname>
-        <refpurpose>режим паузы, вызов клавиатуры</refpurpose>
+        <refpurpose>
+            временно приостанавливает выполнение и разрешает инструкции в консоли.
+        </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>Синтаксис</title>
     <refsection>
         <title>Описание</title>
         <para>
-            Переключение в режим <code>pause</code>. Внесение функции <code>pause</code> в
+            Переключение в режим <function>pause</function>. Внесение функции <function>pause</function> в
             код функции прерывает исполнение функции: появляется символ командной строки, который
-            указывает уровень  <code>pause</code> (например, <literal>-1-&gt;</literal>).
+            указывает уровень  <function>pause</function> (например, <literal>-1-&gt;</literal>).
             Пользователь затем оказывается в новом рабочем окружении, в котором доступны все переменные
-            более низкого уровня (и, особенно, все переменные функции). Чтобы вернуться в вызывающее
-            рабочее окружение, введите команду <code>return</code>.
+            более низкого уровня (и, особенно, все переменные функции) и могут быть изменены вручную
+            при необходимости.
         </para>
         <para>
-            В этом режиме<literal>[...]=return(...)</literal> возвращает переменные аргумента
-            <literal>(...)</literal> в вызывающее рабочее окружение с именами на выходе <literal>
-                [...]
-            </literal>
-            .
-            Таким образом, переменные более низкого уровня защищены и не могут быть
-            изменены.
-        </para>
-        <para>
-            Команда <code>pause</code> чрезвычайно полезна в процессе отладки.
+            Чтобы продолжить выполнение, введите <literal>resume</literal>.
         </para>
         <para>
             Это режим прекращается командой <code>abort</code>.
         </para>
+        <note>
+            Команда <function>pause</function> чрезвычайно полезна в процессе отладки.
+        </note>
     </refsection>
     <refsection>
-        <title>Examples</title>
+        <title>Примеры</title>
         <programlisting role="example"><![CDATA[
-    function c=foo(b)
-    a=42+b
-    disp("Благодаря инструкции pause, вы можете исследовать - имеет ли ''a'' верное значение");
+function c = foo(b)
+    a = 42 + b
+    disp("Благодаря инструкции pause, вы можете исследовать - имеет ли ''a'' верное значение.");
     disp("Значение может быть, если нужно, изменено.");
     pause
-    c=a+2
-    endfunction
+    c = a + 2
+endfunction
+
+a = 3;
+foo(2)
+     ]]></programlisting>
+        <screen><![CDATA[
+--> a = 3;
+--> foo(2)
+  "Благодаря инструкции pause, вы можете исследовать - имеет ли 'a' верное значение."
+  "Значение может быть, если нужно, изменено."
+
+  Введите «resume» или «abort» для возврата на стандартный уровень командной строки.
 
-    foo(2)
- ]]></programlisting>
+-1-> a
+ a  =
+   44.
+
+-1-> a = 0;
+
+-1-> resume
+ ans  =
+   2.
+]]></screen>
     </refsection>
     <refsection role="see also">
         <title>Смотрите также</title>
         <simplelist type="inline">
             <member>
+                <link linkend="debug">debug</link>
+            </member>
+            <member>
                 <link linkend="halt">halt</link>
             </member>
             <member>
                 <link linkend="abort">abort</link>
             </member>
             <member>
-                <link linkend="quit">quit</link>
-            </member>
-            <member>
                 <link linkend="whereami">whereami</link>
             </member>
             <member>
-                <link linkend="where">where</link>
+                <link linkend="sleep">sleep</link>
             </member>
             <member>
-                <link linkend="sleep">sleep</link>
+                <link linkend="quit">quit</link>
             </member>
         </simplelist>
     </refsection>
+    <refsection role="history">
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.0.0</revnumber>
+                <revdescription>
+                    Новые значения локальных переменных, изменённые в течение паузы, теперь
+                    учитываются при возвращении с помощью <literal>resume</literal>.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>