annotate docs/nitros9guide/iniz.refentry @ 3140:03b580a02945

Allow CoCo3FPGA-specific build of superdesc.asm Added new conditional CC3FPGA and code to "level1/modules/superdesc.asm" to reflect changes needed to build the new SD card descriptors for the Coco3FPGA.
author Bill Pierce <merlinious999@gmail.com>
date Sat, 04 Feb 2017 11:06:26 +0100
parents b00cf13c9f61
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
1 <refentry id="iniz">
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
2 <refnamediv>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
3 <refname>INIZ</refname>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
4 <refpurpose>Initialize a device.</refpurpose>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
5 </refnamediv>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
6
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
7 <refsynopsisdiv>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>iniz</command>
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
10 <arg choice="opt">
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
11 <option>devicename [...]</option>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
12 </arg>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
13 </cmdsynopsis>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
14 </refsynopsisdiv>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
15
158
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
16 <refsect1>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
17 <title>Description</title>
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
18 <para>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
19 Links the specified device to NitrOS-9, places the device addres in a new device
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
20 table entry, allocates the memory needed by the device driver, and calls
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
21 the device driver initialization routine. If the device is already
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 158
diff changeset
22 installed, <command>iniz</command> does not reinitialize it.
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
23 </para>
158
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
24 <refsect2>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
25 <title>Options:</title>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
26 <variablelist>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
27 <varlistentry>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
28 <term>devicename</term>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
29 <listitem>
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
30 <para>
158
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
31 is the name of the device drivere you want to
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
32 initialize. Specify as many device drivers as you
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 158
diff changeset
33 wish with one <command>iniz</command> command.
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
34 </para>
158
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
35 </listitem>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
36 </varlistentry>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
37 </variablelist>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
38 </refsect2>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
39 <refsect2>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
40 <title>Notes:</title>
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
41 <para>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
42 You can use Iniz in the startup file or at the system startup to initialize
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
43 devices and allocate their static storage at the top of memory (to reduce
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
44 memory fragmentation).
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
45 </para>
158
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
46 </refsect2>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
47 </refsect1>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
48 <refsect1>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
49 <title>Example:</title>
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
50 <literallayout>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
51 iniz p t2 [ENTER]
158
f04c81aa1759 Changed some stuff into tables.
roug
parents: 155
diff changeset
52 </literallayout>
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
53 <para>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
54 initializes the p (printer) and t2 (terminal 2) devices.
152
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
55 </para>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
56 </refsect1>
6c48191bd06a Refentries for CoCo OS-9 commands
boisy
parents:
diff changeset
57 </refentry>