* [#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.
<?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-></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-></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>
<?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-></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-></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>
<?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-></literal>)を
+ <function>pause</function>モードに切り替えます;
+ 関数のコードに挿入すると,<function>pause</function>は関数の実行を中断し,
+ <function>pause</function>のレベル (例: <literal>-1-></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>
<?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-></literal>). O usuário
+ <function>pause</function> (exemplo: <literal>-1-></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>
<?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-></literal>).
+ указывает уровень <function>pause</function> (например, <literal>-1-></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>