1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
<?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" version="5.0-subset Scilab" xml:lang="en" xml:id="pause">
<info>
<pubdate>$LastChangedDate$</pubdate>
</info>
<refnamediv>
<refname>pause</refname>
<refpurpose> pause mode, invoke keyboard</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
<para>
Switch to the <literal>pause</literal> mode;
inserted in the code of a function, <literal>pause</literal> interrupts the execution
of the function: one receives a prompt symbol which indicates
the level of the <literal>pause</literal> (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 <literal>"return"</literal></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.</para>
<para>
The <literal>pause</literal> is extremely useful for debugging purposes.</para>
<para>
This mode is killed by the command <literal>"abort"</literal>.</para>
</refsection>
<refsection>
<title>See Also</title>
<simplelist type="inline">
<member>
<link linkend="halt">halt</link>
</member>
<member>
<link linkend="return">return</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>
</member>
<member>
<link linkend="sleep">sleep</link>
</member>
</simplelist>
</refsection>
</refentry>
|
