annotate docs/nitros9guide/ex.refentry @ 1299:1f0995cd0431

REL is now back-ported to OS-9 Level One
author boisy
date Mon, 01 Sep 2003 16:59:50 +0000
parents 4dae346c4969
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="ex">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>EX</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Execute program as overlay</refpurpose>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
6
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>ex</command>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
11 <replaceable>module name</replaceable>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
13 <arg choice="opt">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
14 <replaceable>modifiers</replaceable>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
15 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
16 <arg choice="opt">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
17 <replaceable>parameters</replaceable>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
18 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
19 </cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 </refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
21
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 <refsect1><title>Description</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
23 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
24 This a shell built-in command that causes the process executing the
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
25 shell to start execution of another program. It permits a transition
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
26 from the shell to another program without creating another process,
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
27 thus conserving system memory.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
30 This command is often used when the shell is called from another
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
31 program to execute a specific program, after which the shell is not
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
32 needed. For instance, applications which only use <command>basic09</command> need not
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
33 waste memory space on <command>shell</command>.
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
34 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35 <para>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
36 The <command>ex</command> command should always be the last command on a shell input
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37 line because any command line following will never be processed.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39 <para>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
40 NOTE: Since this is a built-in <command>shell</command> command, it does not appear in
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 the CMDS directory.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43 <para>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
44 For more information see: <xref linkend="sec4.5"/>,
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
45 <xref linkend="sec4.6"/>, <xref linkend="sec4.9"/>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
48 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
49 <refsect1><title>Examples</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
50 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
51 ex BASIC09
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
52
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
53 tsmon /t1&amp;; tsmon /t2&amp;; ex tsmon /term
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
54 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
55 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
56 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
57