diff docs/nitros9guide/chap6.chapter @ 1500:b00cf13c9f61

Major changes for new NitrOS-9 manual
author boisy
date Mon, 05 Jan 2004 00:51:19 +0000
parents 4dae346c4969
children
line wrap: on
line diff
--- a/docs/nitros9guide/chap6.chapter	Thu Dec 25 14:19:21 2003 +0000
+++ b/docs/nitros9guide/chap6.chapter	Mon Jan 05 00:51:19 2004 +0000
@@ -1,7 +1,7 @@
 <chapter id="sec6">
 <title>Use of the System Disk</title>
 <para>
-Disk-based OS-9 systems use a system disk to load many parts of
+Disk-based NitrOS-9 systems use a system disk to load many parts of
 the operating system during the system startup and to provide files
 frequently used during normal system operations. Therefore, the
 system disk is generally kept in disk drive zero (&quot;/D0&quot;) when the
@@ -25,9 +25,9 @@
 
 <para>
 The file called <filename>OS9Boot</filename> loaded into RAM memory by the
-&quot;bootstrap&quot; routine located in the OS-9 firmware. It includes file
+&quot;bootstrap&quot; routine located in the NitrOS-9 firmware. It includes file
 managers, device drivers and descriptors, and any other modules
-which are permanently resident in memory. A typical Microware OS-9
+which are permanently resident in memory. The NitrOS-9
 distribution disk's <filename>OS9Boot</filename> file contains the following modules:
 </para>
 <informaltable frame="none">
@@ -36,12 +36,12 @@
 <colspec colwidth="3.5in"/>
 <tbody>
   <row>
-    <entry>OS9P2</entry>
-    <entry>OS-9 Kernel, Part 2</entry>
+    <entry>KernelP2</entry>
+    <entry>NitrOS-9 Kernel, Part 2</entry>
   </row>
   <row>
     <entry>IOMan</entry>
-    <entry>OS-9 Input/Output Manager</entry>
+    <entry>NitrOS-9 Input/Output Manager</entry>
   </row>
   <row>
     <entry>Init</entry>
@@ -104,7 +104,11 @@
     <entry>Real-Time Clock Module</entry>
   </row>
   <row>
-    <entry>CC3Go</entry>
+    <entry>Clock2</entry>
+    <entry>Second Part of Real-Time Clock Module</entry>
+  </row>
+  <row>
+    <entry>SysGo</entry>
     <entry>System Startup Process</entry>
   </row>
 </tbody>
@@ -125,7 +129,7 @@
 <title>The SYS Directory</title>
 
 <para>
-The directory <filename>/d0/SYS</filename> contains two important files:
+The directory <filename>/d0/SYS</filename> contains several important files:
 </para>
 <informaltable frame="none">
 <tgroup cols="2">
@@ -140,13 +144,17 @@
 <entry>errmsg</entry>
 <entry>the error message file</entry>
   </row>
+  <row>
+<entry>helpmsg</entry>
+<entry>the help database file</entry>
+  </row>
 </tbody>
 </tgroup>
 </informaltable>
 <para>
 These files (and the <filename class="directory">SYS</filename> directory itself) are not absolutely
-required to boot OS-9, they are needed if <command>login</command>, <command>tsmon</command>, or
-<command>printerr</command> will be used. Users may add other system-wide files of
+required to boot NitrOS-9, they are needed if <command>login</command>, <command>tsmon</command>, or
+<command>help</command> will be used. Users may add other system-wide files of
 similar nature if desired.
 </para>
 </section>
@@ -155,7 +163,7 @@
 <title>The Startup File</title>
 
 <para>
-The file <filename>/d0/startup</filename> is a shell procedure file which
+The file <filename>startup</filename> in the root directory is a shell procedure file which
 is automatically processed immediately after system startup. The
 user may include in <filename>startup</filename> any legal shell command line. Often
 this will include <command>setime</command> to start the system clock. If this file
@@ -168,10 +176,10 @@
 <title>The CMDS Directory</title>
 
 <para>
-The directory <filename class="directory">/d0/CMDS</filename> is the system-wide command object code
+The directory <filename class="directory">CMDS</filename> is the system-wide command object code
 directory, which is normally shared by all users as their working
 execution directory. If <command>shell</command> is not part of the
-<filename>OS9Boot</filename> file, it must be present in this directory. The system
+<filename>OS9Boot</filename> file (and it shouldn't be in a Level 2 system), it must be present in this directory. The system
 startup process &quot;sysgo&quot; makes <filename class="directory">CMDS</filename> the initial execution directory.
 </para>
 </section>
@@ -180,10 +188,10 @@
 <title>The DEFS Directory</title>
 
 <para>
-The directory <filename class="directory">/d0/DEFS</filename> is a directory that contains assembly
+The directory <filename class="directory">DEFS</filename> is a directory that contains assembly
 language source code files which contain common system-wide symbolic
 definitions, and are normally included in assembly language programs
-by means of the OS-9 Assembler &quot;use&quot; directive. The presence and
+by means of the NitrOS-9 Assembler &quot;use&quot; directive. The presence and
 use of this directory is optional, but highly recommended for any
 system used for assembly language programs. The files commonly
 contained in this directory are:
@@ -267,9 +275,14 @@
 <filename class="directory">SYS</filename> directories and the files they contain must be
 copied.
 </para></listitem>
+
+<listitem><para>
+For Level 2, the <filename>sysgo</filename> file in the root directory must be
+copied.
+</para></listitem>
 </orderedlist>
 
-Steps 2 through 4 may be performed manually, or automatically by any
+Steps 2 through 5 may be performed manually, or automatically by any
 of the following methods:
 <orderedlist  numeration="arabic">
 <listitem><para>