# HG changeset patch
# User roug
# Date 1049749306 0
# Node ID 4dae346c4969d83a6c154c57685780f892b22b14
# Parent  f5d45fbe3a76d990e615e711b1606fc1fee9945d
Added crossreferences and lowercased synopsises

diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/asm.refentry
--- a/docs/nitros9guide/asm.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/asm.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>ASM</command>
+<command>asm</command>
 <arg choice="plain"><replaceable>filename</replaceable></arg>
 <arg choice="opt">opt</arg>
 <arg choice="opt">&gt;list</arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/attr.refentry
--- a/docs/nitros9guide/attr.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/attr.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>ATTR</command>
+<command>attr</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
@@ -46,10 +46,10 @@
 non-directory file if all entries have been deleted from it. Since the
 DEL command will only delete non-directory files, this is the only
 way a directory may be deleted. You cannot change a non-directory
-file to a directory file with this command (see MAKDIR).
+file to a directory file with this command (see <command>makdir</command>).
 </para>
 <para>
-For more information see: 3.8, 3.8.1
+For more information see: <xref linkend="sec3.8"/>, <xref linkend="sec3.8.1"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/backup.refentry
--- a/docs/nitros9guide/backup.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/backup.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>BACKUP</command>
+<command>backup</command>
 <arg choice="opt">
   <option>e</option>
 </arg>
@@ -72,7 +72,7 @@
 fewer disk exchanges to be required.
 </para>
 <para>
-For more information see: 1.1.2
+For more information see: <xref linkend="sec1.1.2"/>
 </para>
 <screen>
 OS9:backup /D0 #10k
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/basic09.refentry
--- a/docs/nitros9guide/basic09.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/basic09.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>BASIC09</command>
+<command>basic09</command>
 <arg choice="opt"><replaceable>filename</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/binex.refentry
--- a/docs/nitros9guide/binex.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/binex.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-    <command>BINEX</command>
+    <command>binex</command>
     <arg choice="plain"><replaceable>path1</replaceable></arg>
     <arg choice="plain"><replaceable>path2</replaceable></arg>
 </cmdsynopsis>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/build.refentry
--- a/docs/nitros9guide/build.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/build.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>BUILD</command>
+<command>build</command>
 <arg choice="plain"><replaceable>path</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/cc.refentry
--- a/docs/nitros9guide/cc.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/cc.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>CC</command>
+<command>cc</command>
 <arg>options</arg>
 <arg rep="repeat" choice="plain"><replaceable>file</replaceable></arg>
 <arg>options</arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap1.chapter
--- a/docs/nitros9guide/chap1.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap1.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -1,7 +1,7 @@
 <chapter>
 <title>Getting Started...</title>
 
-<section>
+<section id="sec1.0">
 <title>What You Need to Run OS-9</title>
 <para>
 This version of &os9level; runs on the &make;. To use it you'll need the following:
@@ -24,7 +24,7 @@
   <listitem><para>Other OS-9 Compatible Languages and Software</para></listitem>
 </itemizedlist>
 
-<section>
+<section id="sec1.0.1">
 <title>Starting the System</title>
 <para>
 To start up OS-9 follow these steps:
@@ -47,7 +47,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec1.0.2">
 <title>In Case You Have Problems Starting OS-9</title>
 <itemizedlist>
 <listitem><para>If BASIC gives an error message after you
@@ -59,7 +59,8 @@
 
 <listitem><para>Does your &make; have &minmem; RAM? This is a must!</para></listitem>
 
-<listitem><para>If your &make; doesn't seem to understand the &DOSCMD; command, your controller has DOS 1.0.  You will need to upgrade to
+<listitem><para>If your &make; doesn't seem to understand the &DOSCMD; command,
+your controller has DOS 1.0.  You will need to upgrade to
 DOS 1.1.</para></listitem>
 
 <listitem><para>If the &quot;OS9 BOOT&quot; message is displayed but nothing else happens,
@@ -68,7 +69,7 @@
 </itemizedlist>
 </section>
 
-<section>
+<section id="sec1.0.3">
 <title>A Quick Introduction to the Use of the Keyboard and Disks</title>
 <para>
 For now, the only special keys on the keyboard of interest are
@@ -85,7 +86,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec1.0.4">
 <title>Initial Explorations</title>
 <para>
 When OS-9 first starts up, it will display a welcoming message,
@@ -180,7 +181,7 @@
 </para>
 </section>
 </section>
-<section>
+<section id="sec1.1">
 <title>Making a Backup of the System Disk</title>
 <para>
 Before getting too much more involved in further experimentation,
@@ -189,7 +190,7 @@
 Disk. Making a backup involves two steps: formatting a blank disk
 and running a backup program.
 </para>
-<section>
+<section id="sec1.1.1">
 <title>Formatting Blank Disks</title>
 <para>
 Before the actual backup procedure can be done (or any fresh
@@ -244,7 +245,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec1.1.2">
 <title>Running the Backup Program</title>
 <para>
 The <command>backup</command> program makes an exact duplicate of a disk. It can be
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap2.chapter
--- a/docs/nitros9guide/chap2.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap2.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -1,7 +1,7 @@
 <chapter>
 <title>Basic Interactive Functions</title>
 
-<section>
+<section id="sec2.0">
 <title>Running Commands and Basic Shell Operation</title>
 <para>
 The <command>shell</command> is a the part of OS-9 that accepts commands from your
@@ -80,7 +80,7 @@
 
 
 </para>
-<section>
+<section id="sec2.0.1">
 <title>Sending Output to the Printer</title>
 <para>
 Normally, most commands and programs display output on the &make; video display. The output of these programs can
@@ -92,9 +92,9 @@
 &gt;/p
 </screen>
 <para>
-The &quot;&gt;&quot; character tells the shell to redirect output (See 4.3.2) to
+The &quot;&gt;&quot; character tells the shell to redirect output (See <xref linkend="sec4.3.2"/>) to
 the printer using the &make;'s printer port, which has the device
-name &quot;/P&quot; (See 3.2). For example, to redirect the output of the
+name &quot;/P&quot; (See <xref linkend="sec3.2"/>). For example, to redirect the output of the
 <command>dir</command> command to the printer, enter:
 </para>
 <screen>
@@ -119,7 +119,7 @@
 </section>
 </section>
 
-<section>
+<section id="sec2.1">
 <title>Shell Command Line Parameters</title>
 <para>
 Parameters are generally used to either specify file name(s) or
@@ -188,7 +188,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec2.3">
 <title>Some Common Command Formats</title>
 <para>
 This section is a summary of some commands commonly used by new
@@ -243,7 +243,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec2.4">
 <title>Using the Keyboard and Video Display</title>
 <para>
 OS-9 has many features to expand the capability of the &make;
@@ -251,7 +251,8 @@
 upper/lower case, and graphics functions. The keyboard can generate
 all ASCII characters and has a type-ahead feature that permits you
 to enter data before requested by a program (except if the disk is
-running because interrupts are temporarily disabled). Appendix C of
+running because interrupts are temporarily disabled).
+<xref linkend="video-display"/> of
 this manual is a list of the characters and codes that can be
 generated from the keyboard. The keyboard/video display can be used
 as a file known by the name &quot;/TERM&quot;.
@@ -280,7 +281,7 @@
 <para>
 The display system also has a complete set of commands to emulate
 commercial data terminals, plus a complete set of graphics commands.
-These are described in detail in Appendix D.
+These are described in detail in <xref linkend="key-definitions"/>.
 </para>
 </section>
 
@@ -305,7 +306,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec2.4.3">
 <title>Control Key Functions</title>
 <para>
 There are a number of useful control functions that can be
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap3.chapter
--- a/docs/nitros9guide/chap3.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap3.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -60,7 +60,7 @@
 </itemizedlist>
 </section>
 
-<section>
+<section id="sec3.1">
 <title>Pathlists: How Paths Are Named</title>
 <para>
 Whenever a path is established (or &quot;opened&quot;), OS-9 must be given
@@ -159,7 +159,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.2">
 <title>I/O Device Names</title>
 <para>
 Each physical input/output device supported by the system must
@@ -221,7 +221,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.3">
 <title>Multifile Devices And Directory Files</title>
 <para>
 Multifile devices are mass storage devices (usually disk systems)
@@ -302,12 +302,12 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.4">
 <title>Creating and Using Directories</title>
 <para>
 It is possible to create a virtually unlimited number of levels
 of directories on a mass storage device using the <command>makdir</command> command.
-Directories are a special type of file (see 3.8.1). They can be
+Directories are a special type of file (see <xref linkend="sec3.8.1"/>). They can be
 processed by the same I/O functions used to access regular files
 which makes directory-related processing fairly simple.
 </para>
@@ -380,7 +380,7 @@
 To make a new directory in this directory, the <command>makdir</command> command is
 used. The new directory will be called <filename class="directory">NEWDIR</filename>. Notice that
 throughout this manual directory names are always capitalized. This
-is <emphasis>not</emphasis> a requirement of OS-9 (see 3.1) . Rather, it is a
+is <emphasis>not</emphasis> a requirement of OS-9 (see <xref linkend="sec3.1"/>) . Rather, it is a
 practice popular with many OS-9 users because it allows easy identification
 of directory files at all times (assuming all other file names use
 lower-case letters).
@@ -440,7 +440,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.5">
 <title>Deleting Directory Files</title>
 <para>
 The <command>del</command> command cannot be used to directly delete a directory
@@ -454,7 +454,7 @@
 </para>
 <para>
 2. The <command>attr</command> command is used to turn off the files directory
-attrribute (-d option), making it an ordinary file (see 3.8).
+attrribute (-d option), making it an ordinary file (see <xref linkend="sec3.8"/>).
 </para>
 <para>
 3. The file may now be deleted using the <command>del</command> command.
@@ -465,7 +465,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.6">
 <title>Additional Information About Directories</title>
 <para>
 The OS-9 directory system is very useful because it allows each
@@ -500,7 +500,7 @@
 </itemizedlist>
 </section>
 
-<section>
+<section id="sec3.7">
 <title>Using and Changing Working Directories</title>
 <para>
 Each program (process) has two &quot;working directories&quot; associated
@@ -508,7 +508,7 @@
 directory&quot;. The working directory mechanism allows the name searching
 involved in pathlist processing to start at any level (subtree)
 of the file system hierarchy. Any directory that the user has
-permission to access (see 3.8) can be made a working directory.
+permission to access (see <xref linkend="sec3.8"/>) can be made a working directory.
 </para>
 <para>
 The rules used to determine whether pathlists refer to the
@@ -568,7 +568,7 @@
 /D1/PETE/GAMES/ACTION/racing
 </para>
 
-<section>
+<section id="sec3.7.1">
 <title>Automatic Selection of Working Directories</title>
 <para>
 Recall that two working directories are referred to as the
@@ -597,7 +597,7 @@
 drive (<filename class="directory">/D0/cmds</filename>). On timesharing systems, the <command>login</command> command
 selects the initial execution and data directories to the file names
 specified in each user's information record stored in the system
-password file(ref. 5.4.2).
+password file(ref. <xref linkend="sec5.4.2"/>).
 </para>
 <para>
 Here is an example of a <command>shell</command> command statement using the default
@@ -622,7 +622,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.7.2">
 <title>Changing Current Working Directories</title>
 <para>
 The built-in shell commands <command>chd</command> and <command>chx</command> can be used to
@@ -654,7 +654,7 @@
 </screen>
 </section>
 
-<section>
+<section id="sec3.7.3">
 <title>Anonymous Directory Names</title>
 <para>
 Sometimes is useful to be able to refer to the current directory
@@ -709,7 +709,7 @@
 </section>
 </section>
 
-<section>
+<section id="sec3.8">
 <title>The File Security System</title>
 <para>
 Every file (including directory files) has properties called
@@ -772,7 +772,7 @@
 execute it, but not read, copy, delete, or alter it.
 </para>
 
-<section>
+<section id="sec3.8.1">
 <title>Examining and Changing File Attributes</title>
 <para>
 The <command>dir</command> command may be used to examine the security permissions
@@ -838,7 +838,7 @@
 </section>
 </section>
 
-<section>
+<section id="sec3.9">
 <title>Reading and Writing From Files</title>
 <para>
 A single file type and format is used for all mass storage files.
@@ -870,7 +870,7 @@
 &quot;read&quot; request to return an end-of-file status.
 </para>
 
-<section>
+<section id="sec3.9.1">
 <title>File Usage in OS-9</title>
 <para>
 Even though there is physically only one type of file, the logical
@@ -890,7 +890,7 @@
 </simplelist>
 </section>
 
-<section>
+<section id="sec3.9.2">
 <title>Text Files</title>
 <para>
 These files contain variable-length sequences (&quot;lines&quot;) of ASCII
@@ -914,7 +914,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.9.3">
 <title>Random Access Data Files</title>
 <para>
 Random-access data files are created and used primarily from
@@ -946,7 +946,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.9.4">
 <title>Executable Program Module Files</title>
 <para>
 These files are used to hold program modules generated by the
@@ -987,33 +987,33 @@
 </para>
 </section>
 
-<section>
+<section id="sec3.9.5">
 <title>Directory Files</title>
 <para>
 Directory files play a key role in the OS-9 file system.  They can only be created by the <command>makdir</command> command, and
-can be identified by the &quot;d&quot; attribute being set (see 3.8.1). The
+can be identified by the &quot;d&quot; attribute being set (see <xref linkend="sec3.8.1"/>). The
 file is organized into 32-byte records. Each record can be a
 directory entry. The first 29 bytes of the record is a string of
 characters which is the file name. The last character of the name
 has its sign bit (most significant bit) set. If the record is not
 in use the first character position will have the value zero. The
 last three bytes of the record is a 24-bit binary number which is
-the logical sector number where the file header record (see 3.10) is
+the logical sector number where the file header record (see <xref linkend="sec3.10"/>) is
 located.
 </para>
 <para>
 The <command>makdir</command> command initializes all records in a new directory
 to be unused entries except for the first two entries. These
 entries have the names <filename class="directory">.</filename> and <filename class="directory">..</filename> along with the logical sector
-numbers of the directory and its parent directory, respectively (see 3.7.3).
+numbers of the directory and its parent directory, respectively (see <xref linkend="sec3.7.3"/>).
 </para>
 <para>
 Directories cannot be copied or listed - the <command>dir</command> command is
-used instead. Directories also cannot be deleted directly (see 3.5).
+used instead. Directories also cannot be deleted directly (see <xref linkend="sec3.5"/>).
 </para>
 </section>
 
-<section>
+<section id="sec3.9.6">
 <title>Miscellaneous File Usage</title>
 <para>
 OS-9's basic file functions are so versatile it is possible to
@@ -1032,7 +1032,7 @@
 </section>
 </section>
 
-<section>
+<section id="sec3.10">
 <title>Physical File Organization</title>
 <para>
 OS-9's file system implements a universal logical organization
@@ -1081,7 +1081,7 @@
 </para></listitem>
 </itemizedlist>
 <para>
-Each file has a directory entry (see 3.9.5) which includes the
+Each file has a directory entry (see <xref linkend="sec3.9.5"/>) which includes the
 file name and the logical sector number of the file's &quot;file descriptor
 sector&quot;, which contains a complete description of the file
 including:
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap4.chapter
--- a/docs/nitros9guide/chap4.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap4.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -243,7 +243,7 @@
 </section>
 </section>
 
-<section>
+<section id="sec4.3">
 <title>Command Separators</title>
 <para>
 A single shell input line can request execution of more than one
@@ -255,7 +255,7 @@
 
 </para>
 
-<section>
+<section id="sec4.3.1">
 <title>Sequential Execution</title>
 <para>
 Programs are executed sequentially when each is entered on a
@@ -293,7 +293,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec4.3.2">
 <title>Concurrent Execution</title>
 <para>
 The second kind of separator is the &quot;&amp;&quot; which implies concurrent
@@ -338,7 +338,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec4.3.3">
 <title>Pipes and Filters</title>
 <para>
 The third kind of separator is the &quot;!&quot; character which is used to
@@ -443,7 +443,7 @@
 </screen>
 </section>
 
-<section>
+<section id="sec4.5">
 <title>Built-in Shell Commands and Options</title>
 <para>
 When processing input lines, the shell looks for several special
@@ -535,7 +535,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec4.6">
 <title>Shell Procedure Files</title>
 <para>
 The shell is a reentrant program that can be simultaneously
@@ -616,7 +616,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec4.7">
 <title>Error Reporting</title>
 <para>
 Many programs (including the shell) use OS-9's standard error
@@ -640,7 +640,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec4.8">
 <title>Running Compiled Intermediate Code Programs</title>
 <para>
 Before the shell executes a program, it checks the program
@@ -667,7 +667,7 @@
 </screen>
 </section>
 
-<section>
+<section id="sec4.9">
 <title>Setting Up Timesharing System Procedure Files</title>
 
 <para>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap5.chapter
--- a/docs/nitros9guide/chap5.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap5.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -41,7 +41,7 @@
 system throughput and capacity.
 </para>
 
-<section>
+<section id="sec5.1">
 <title>Processor Time Allocation and Timeslicing</title>
 
 <para>
@@ -92,7 +92,7 @@
 </screen>
 </section>
 
-<section>
+<section id="sec5.2">
 <title>Process States</title>
 
 <para>
@@ -133,7 +133,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec5.3">
 <title>Creation of New Processes</title>
 
 <para>
@@ -255,7 +255,7 @@
 
 </section>
 
-<section>
+<section id="sec5.4">
 <title>Basic Memory Management Functions</title>
 <para>
 An important OS-9 function is memory management. OS-9 automatically allocates
@@ -288,7 +288,7 @@
                 !                           !
                 +---------------------------+  lowest address (0)
 </screen>
-<section>
+<section id="sec5.4.1">
 <title>Loading Program Modules Into Memory</title>
 
 <para>
@@ -389,7 +389,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec5.4.2">
 <title>Loading Multiple Programs</title>
 
 <para>
@@ -416,7 +416,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec5.4.3">
 <title>Memory Fragmentation</title>
 
 <para>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap6.chapter
--- a/docs/nitros9guide/chap6.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap6.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -1,4 +1,4 @@
-<chapter>
+<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
@@ -20,7 +20,7 @@
 initial data directory.
 </para>
 
-<section>
+<section id="sec6.1">
 <title>The OS9Boot File</title>
 
 <para>
@@ -121,7 +121,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec6.2">
 <title>The SYS Directory</title>
 
 <para>
@@ -151,7 +151,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec6.3">
 <title>The Startup File</title>
 
 <para>
@@ -164,7 +164,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec6.4">
 <title>The CMDS Directory</title>
 
 <para>
@@ -176,7 +176,7 @@
 </para>
 </section>
 
-<section>
+<section id="sec6.5">
 <title>The DEFS Directory</title>
 
 <para>
@@ -215,7 +215,7 @@
 
 </section>
 
-<section>
+<section id="sec6.6">
 <title>Changing System Disks</title>
 
 <para>
@@ -242,7 +242,7 @@
 
 </section>
 
-<section>
+<section id="sec6.7">
 <title>Making New System Disks</title>
 
 <para>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chap7.chapter
--- a/docs/nitros9guide/chap7.chapter	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chap7.chapter	Mon Apr 07 21:01:46 2003 +0000
@@ -123,6 +123,7 @@
 &mergeref;
 &mfreeref;
 &os9genref;
+&printerrref;
 &procref;
 &procsref;
 &pwdref;
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/chd.refentry
--- a/docs/nitros9guide/chd.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/chd.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -33,7 +33,7 @@
 are built-in to the <command>shell</command>.
 </para>
 <para>
-For more information see: 3.7, 3.7.2
+For more information see: <xref linkend="sec3.7"/>, <xref linkend="sec3.7.2"/>
 
 
 </para>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/cobbler.refentry
--- a/docs/nitros9guide/cobbler.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/cobbler.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>COBBLER</command>
+<command>cobbler</command>
 <arg choice="plain">
   <replaceable>device name</replaceable>
 </arg>
@@ -34,7 +34,7 @@
 able to boot from that disk until it is reformatted.
 </para>
 <para>
-For more information see: 1.1.2, 6.1
+For more information see: <xref linkend="sec1.1.2"/>, <xref linkend="sec6.1"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/config.refentry
--- a/docs/nitros9guide/config.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/config.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>CONFIG</command>
+<command>config</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/copy.refentry
--- a/docs/nitros9guide/copy.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/copy.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>COPY</command>
+<command>copy</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/cputype.refentry
--- a/docs/nitros9guide/cputype.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/cputype.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>CPUTYPE</command>
+<command>cputype</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/date.refentry
--- a/docs/nitros9guide/date.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/date.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DATE</command>
+<command>date</command>
 <arg choice="opt">
   <option>-t</option>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dcheck.refentry
--- a/docs/nitros9guide/dcheck.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dcheck.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DCHECK</command>
+<command>dcheck</command>
 <arg choice="opt">
   <option>-opts</option>
 </arg>
@@ -22,7 +22,7 @@
 but in fact are not actually associated with a file or the disk's
 free space. This can happen if a disk is removed from a drive while
 files are still open, or if a directory which still contains files
-is deleted (see 3.5). <command>Dcheck</command> is a diagnostic that can be used to
+is deleted (see <xref linkend="sec3.5"/>). <command>Dcheck</command> is a diagnostic that can be used to
 detect this condition, as well as the general integrity of the directory/file linkages.
 </para>
 <para>
@@ -164,8 +164,10 @@
 depth greater than 39 levels.
 </para>
 <para>
-For more information see: 3.10, 3.5, FORMAT,
-                          6.1 of OS-9 Systems Programmer's Manual
+For more information see: <xref linkend="sec3.10"/>,
+<xref linkend="sec3.5"/>,
+<command>format</command>,
+6.1 of OS-9 Systems Programmer's Manual
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/debug.refentry
--- a/docs/nitros9guide/debug.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/debug.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DEBUG</command>
+<command>debug</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/ded.refentry
--- a/docs/nitros9guide/ded.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/ded.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DED</command>
+<command>ded</command>
 <arg choice="plain"><replaceable>pathlist</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/deiniz.refentry
--- a/docs/nitros9guide/deiniz.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/deiniz.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DEINIZ</command>
+<command>deiniz</command>
 <arg choice="opt">
   <option>devicename [...]</option>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/del.refentry
--- a/docs/nitros9guide/del.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/del.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DEL</command>
+<command>del</command>
 <arg choice="opt">
   <option>-x</option>
 </arg>
@@ -27,14 +27,14 @@
 This command is used to delete the file(s) specified by the
 pathlist(s). The user must have write permission for the file(s).
 Directory files cannot be deleted unless their type is changed to
-non-directory: see the <command>ATTR</command> command description.
+non-directory: see the <command>attr</command> command description.
 </para>
 <para>
 If the -x option appears, the current
 <emphasis>execution</emphasis> directory is assumed.
 </para>
 <para>
-For more information see: 3.5, 3.8.1
+For more information see: <xref linkend="sec3.5"/>, <xref linkend="sec3.8.1"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/deldir.refentry
--- a/docs/nitros9guide/deldir.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/deldir.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DELDIR</command>
+<command>deldir</command>
 <arg choice="plain">
   <replaceable>directory name</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/devs.refentry
--- a/docs/nitros9guide/devs.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/devs.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DEVS</command>
+<command>devs</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dir.refentry
--- a/docs/nitros9guide/dir.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dir.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DIR</command>
+<command>dir</command>
 <arg choice="opt">
   <option>-e</option>
 </arg>
@@ -37,7 +37,7 @@
 
 </para>
 <para>
-For more information see: 1.0.3, 3.4, and 3.8.1
+For more information see: <xref linkend="sec1.0.3"/>, <xref linkend="sec3.4"/>, and <xref linkend="sec3.8.1"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dirm.refentry
--- a/docs/nitros9guide/dirm.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dirm.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DIRM</command>
+<command>dirm</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -33,11 +33,11 @@
 </para>
 <para>
 WARNING: Many of the modules listed by <command>dirm</command> are OS-9 system modules
-and NOT executable as programs: always check the module type code
+and <emphasis>not</emphasis> executable as programs: always check the module type code
 before running a module if you are not familiar with it!
 </para>
 <para>
-For more information see: 5.4.1
+For more information see: <xref linkend="sec5.4.1"/>
 </para>
 </refsect1>
 </refentry>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/disasm.refentry
--- a/docs/nitros9guide/disasm.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/disasm.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DISASM</command>
+<command>disasm</command>
 <group>
 <arg choice="opt">-m <replaceable>module name</replaceable></arg>
 <arg choice="plain"><replaceable>filename</replaceable></arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/display.appendix
--- a/docs/nitros9guide/display.appendix	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/display.appendix	Mon Apr 07 21:01:46 2003 +0000
@@ -1,4 +1,4 @@
-<appendix>
+<appendix id="video-display">
 <title>VDG Display System Functions</title>
 
 <section>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/display.refentry
--- a/docs/nitros9guide/display.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/display.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DISPLAY</command>
+<command>display</command>
 <arg choice="plain">
   <replaceable>hex</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dmem.refentry
--- a/docs/nitros9guide/dmem.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dmem.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DMEM</command>
+<command>dmem</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dmode.refentry
--- a/docs/nitros9guide/dmode.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dmode.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DMODE</command>
+<command>dmode</command>
 <group>
 <arg choice="plain"><replaceable>devicename</replaceable></arg>
 <arg choice="plain">-<replaceable>filename</replaceable></arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dsave.refentry
--- a/docs/nitros9guide/dsave.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dsave.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DSAVE</command>
+<command>dsave</command>
 <arg choice="opt">
   <option>-opts</option>
 </arg>
@@ -90,7 +90,7 @@
 
 
 <para>
-For more information see: 1.1.3
+For more information see: <xref linkend="sec2.3"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/dump.refentry
--- a/docs/nitros9guide/dump.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/dump.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>DUMP</command>
+<command>dump</command>
 <arg choice="opt">
   <replaceable>path</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/echo.refentry
--- a/docs/nitros9guide/echo.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/echo.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>ECHO</command>
+<command>echo</command>
 <arg choice="plain">
   <replaceable>text</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/error.refentry
--- a/docs/nitros9guide/error.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/error.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>ERROR</command>
+<command>error</command>
 <arg choice="plain">
   <replaceable>errno</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/ex.refentry
--- a/docs/nitros9guide/ex.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/ex.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>EX</command>
+<command>ex</command>
 <arg choice="plain">
   <replaceable>module name</replaceable>
 </arg>
@@ -29,19 +29,20 @@
 <para>
 This command is often used when the shell is called from another
 program to execute a specific program, after which the shell is not
-needed. For instance, applications which only use BASIC09 need not
-waste memory space on SHELL.
+needed. For instance, applications which only use <command>basic09</command> need not
+waste memory space on <command>shell</command>.
 </para>
 <para>
 The <command>ex</command> command should always be the last command on a shell input
 line because any command line following will never be processed.
 </para>
 <para>
-NOTE: Since this is a built-in SHELL command, it does not appear in
+NOTE: Since this is a built-in <command>shell</command> command, it does not appear in
 the CMDS directory.
 </para>
 <para>
-For more information see: 4.5, 4.6, 4.9
+For more information see: <xref linkend="sec4.5"/>,
+<xref linkend="sec4.6"/>, <xref linkend="sec4.9"/>
 
 </para>
 </refsect1>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/exbin.refentry
--- a/docs/nitros9guide/exbin.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/exbin.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-    <command>EXBIN</command>
+    <command>exbin</command>
     <arg choice="plain"><replaceable>path2</replaceable></arg>
     <arg choice="plain"><replaceable>path1</replaceable></arg>
 </cmdsynopsis>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/exmode.refentry
--- a/docs/nitros9guide/exmode.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/exmode.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>EXMODE</command>
+<command>exmode</command>
 <arg choice="plain"><replaceable>devname</replaceable></arg>
 <arg choice="opt"><replaceable>arglist</replaceable></arg>
 </cmdsynopsis>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/format.refentry
--- a/docs/nitros9guide/format.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/format.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>FORMAT</command>
+<command>format</command>
 <arg choice="plain">
   <replaceable>devname</replaceable>
 </arg>
@@ -58,7 +58,7 @@
 can later be displayed using the FREE command.
 </para>
 <para>
-For more information see: 3.10
+For more information see: <xref linkend="sec3.10"/>
 </para>
 </refsect1>
 </refentry>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/free.refentry
--- a/docs/nitros9guide/free.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/free.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>FREE</command>
+<command>free</command>
 <arg choice="plain">
   <replaceable>devname</replaceable>
 </arg>
@@ -31,7 +31,7 @@
 could be created even if each has only one cluster.
 </para>
 <para>
-For more information see: 3.10
+For more information see: <xref linkend="sec3.10"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/go51.refentry
--- a/docs/nitros9guide/go51.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/go51.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>GO51</command>
+<command>go51</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -37,14 +37,15 @@
 emulate commercial data terminals. In addition to the video screen
 driver, <command>go51</command> provides a new keyboard driver which features auto-repeat.
 The keyboard code allocation is the same as described in
-section 2.4.3 and Appendix D.
+section <xref linkend="sec2.4.3"/> and <xref linkend="key-definitions"/>
 </para>
 </refsect1>
 <refsect1>
 <title>The GO51 Display Functions</title>
 <para>
 Like the normal 32 by 16 video display functions described in
-Appendix C the 51 by 24 mode provides many built in facilities to
+<xref linkend="video-display"/>
+the 51 by 24 mode provides many built in facilities to
 control the display. These functions are activated by the use of
 the various escape sequences and control characters described below:
 </para>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/help.refentry
--- a/docs/nitros9guide/help.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/help.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>HELP</command>
+<command>help</command>
 <arg choice="opt">
   <option>command - the command for which you want syntax help.  Include
 as many command names in one <command>help</command> line as you wish.  The proper form and
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/ident.refentry
--- a/docs/nitros9guide/ident.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/ident.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>IDENT</command>
+<command>ident</command>
 <arg choice="opt">
   <option>-opts</option>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/iniz.refentry
--- a/docs/nitros9guide/iniz.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/iniz.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>INIZ</command>
+<command>iniz</command>
 <arg choice="opt">
   <option>devicename [...]</option>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/irqs.refentry
--- a/docs/nitros9guide/irqs.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/irqs.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>IRQS</command>
+<command>irqs</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/keys.appendix
--- a/docs/nitros9guide/keys.appendix	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/keys.appendix	Mon Apr 07 21:01:46 2003 +0000
@@ -1,4 +1,4 @@
-<appendix>
+<appendix id="key-definitions">
 <title>Key Definitions With Hexadecimal Values</title>
 <literallayout class="monospaced">
 NORM  SHFT   CTRL     NORM  SHFT   CTRL     NORM  SHFT   CTRL
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/kill.refentry
--- a/docs/nitros9guide/kill.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/kill.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>KILL</command>
+<command>kill</command>
 <arg choice="plain">
   <replaceable>procID</replaceable>
 </arg>
@@ -31,7 +31,8 @@
 Since this is a built-in <command>shell</command> command, it does not appear in the
 CMDS directory.
 
-For more information see: 4.5, 5.2, <command>procs</command>
+For more information see: <xref linkend="sec4.5"/>,
+<xref linkend="sec5.2"/>, <command>procs</command>
 
 </para>
 </refsect1>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/link.refentry
--- a/docs/nitros9guide/link.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/link.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>LINK</command>
+<command>link</command>
 <arg choice="plain">
   <replaceable>memory module name</replaceable>
 </arg>
@@ -22,7 +22,8 @@
 the module when it is no longer needed.
 </para>
 <para>
-For more information see: 5.4, 5.4.1, 5.4.2, 5.4.3
+For more information see: <xref linkend="sec5.4"/>,
+<xref linkend="sec5.4.1"/>, <xref linkend="sec5.4.2"/>, <xref linkend="sec5.4.3"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/list.refentry
--- a/docs/nitros9guide/list.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/list.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>LIST</command>
+<command>list</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
@@ -28,7 +28,7 @@
 This command is most commonly used to examine or print text files.
 </para>
 <para>
-For more information see: 2.3, 3.9.2
+For more information see: <xref linkend="sec2.3"/>, <xref linkend="sec3.9.2"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/load.refentry
--- a/docs/nitros9guide/load.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/load.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>LOAD</command>
+<command>load</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
@@ -22,7 +22,8 @@
 revision level is kept.
 </para>
 <para>
-For more information see: 3.9.4, 5.4.1, 5.4.2
+For more information see: <xref linkend="sec3.9.4"/>,
+<xref linkend="sec5.4.1"/>, <xref linkend="sec5.4.2"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/login.refentry
--- a/docs/nitros9guide/login.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/login.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>LOGIN</command>
+<command>login</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -41,10 +41,10 @@
 This number is used by the file security system and as the system-wide
 user ID to identify all processes initiated by the user. The
 system manager should assign a unique ID to each potential user.
-(See 3.8)
+(See <xref linkend="sec3.8"/>)
 </para>
 <para>
-4. Initial process (CPU time) priority: 1 - 255 (see 5.2)
+4. Initial process (CPU time) priority: 1 - 255 (see <xref linkend="sec5.2"/>)
 </para>
 <para>
 5. Pathlist of initial execution directory (usually <filename class="directory">/d0/CMDS</filename>)
@@ -80,7 +80,7 @@
 execution directory, working data directory, and executes the
 initial program specified by the password file. The date, time and
 process number (which is <emphasis>not</emphasis> the same as
-the user ID, see 5.3) are also displayed.
+the user ID, see <xref linkend="sec5.3"/>) are also displayed.
 </para>
 <para>
 Note: if the shell from which <command>login</command> was called will not be needed
@@ -100,14 +100,15 @@
 </para>
 </refsect2>
 <refsect2>
-<title>Displaying a &quot;Message-of-the-Day&quot;</title>
+<title>Displaying a <quote>Message-of-the-Day</quote></title>
 <para>
 If desired, a file named <filename>motd</filename> appearing in the SYS directory will
 cause <command>login</command> to display it's contents on the user's terminal after
 successful login. This file is not required for <command>login</command> to operate.
 </para>
 <para>
-For more information see: tsmon, 2.5, 3.8, 5.3
+For more information see: <command>tsmon</command>, <xref linkend="sec4.9"/>,
+<xref linkend="sec3.8"/>, <xref linkend="sec5.3"/>
 </para>
 </refsect2>
 </refsect1>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/makdir.refentry
--- a/docs/nitros9guide/makdir.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/makdir.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>MAKDIR</command>
+<command>makdir</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
@@ -22,14 +22,15 @@
 <para>
 The new directory is initialized and initially does not contain
 files except for the <filename class="directory">.</filename> and <filename class="directory">..</filename> pointers to its parent directory
-and itself, respectively (see 3.7.3). All access permissions are
+and itself, respectively (see <xref linkend="sec3.7.3"/>). All access permissions are
 enabled (except sharable).
 </para>
 <para>
 It is customary (but not mandatory) to capitalize directory names.
 </para>
 <para>
-For more information see: 3.3, 3.4, 3.5,3.7.3, 3.9.5
+For more information see: <xref linkend="sec3.3"/>, <xref linkend="sec3.4"/>,
+<xref linkend="sec3.5"/>, <xref linkend="sec3.7.3"/>, <xref linkend="sec3.9.5"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/makefile
--- a/docs/nitros9guide/makefile	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/makefile	Mon Apr 07 21:01:46 2003 +0000
@@ -36,7 +36,7 @@
 
 clean:
 	$(RM) *.htm *.html $(BOOKL1).pdf $(BOOKL1).ps $(BOOKL2).pdf \
-	$(BOOKL2).ps
+	$(BOOKL2).ps *.log *.out *.aux
 
 SRCS          = $(CHAPS) $(APXS) $(REFS)
 CHAPS         = intro.preface \
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/mdir.refentry
--- a/docs/nitros9guide/mdir.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/mdir.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>MDIR</command>
+<command>mdir</command>
 <arg choice="opt">
   <option>-e</option>
 </arg>
@@ -55,7 +55,7 @@
 before running a module if you are not familiar with it!
 </para>
 <para>
-For more information see: 5.4.1
+For more information see: <xref linkend="sec5.4.1"/>
 </para>
 </refsect1>
 </refentry>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/merge.refentry
--- a/docs/nitros9guide/merge.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/merge.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>MERGE</command>
+<command>merge</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/mfree.refentry
--- a/docs/nitros9guide/mfree.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/mfree.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>MFREE</command>
+<command>mfree</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -16,10 +16,10 @@
 and available for assignment. The address and size of each free
 memory block are displayed. The size is given as the number of 256-byte
 pages. This information is useful to detect and correct memory
-fragmentation (see 5.4.3).
+fragmentation (see <xref linkend="sec5.4.3"/>).
 </para>
 <para>
-For more information see: 5.4, 5.4.3
+For more information see: <xref linkend="sec5.4"/>, <xref linkend="sec5.4.3"/>
 
 </para>
 </refsect1>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/nitros9l2guide.docbook
--- a/docs/nitros9guide/nitros9l2guide.docbook	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/nitros9l2guide.docbook	Mon Apr 07 21:01:46 2003 +0000
@@ -76,6 +76,7 @@
   <!ENTITY modpatch      SYSTEM "modpatch.refentry">
   <!ENTITY os9genref     SYSTEM "os9gen.refentry">
   <!ENTITY pmapref       SYSTEM "pmap.refentry">
+  <!ENTITY printerrref   "">
   <!ENTITY procref       SYSTEM "proc.refentry">
   <!ENTITY procsref      "">
   <!ENTITY pwdref        SYSTEM "pwd.refentry">
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/os9gen.refentry
--- a/docs/nitros9guide/os9gen.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/os9gen.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>OS9GEN</command>
+<command>os9gen</command>
 <arg choice="plain">
   <replaceable>device name</replaceable>
 </arg>
@@ -29,7 +29,7 @@
 pathlist per line. Every file named is opened and copied to
 <filename>TempBoot</filename>. This is repeated until end-of-file or a blank line is
 reached on <command>OS9Gen</command>'s standard input. All boot files must contain the
-OS-9 component modules listed in section 6.1.
+OS-9 component modules listed in section <xref linkend="sec6.1"/>.
 </para>
 <para>
 After all input files have been copied to <filename>TempBoot</filename>, the old
@@ -53,7 +53,8 @@
 last pathlist.
 </para>
 <para>
-For more information see: 6.0, 6.1, 6.6
+For more information see: <xref linkend="sec6"/>,
+<xref linkend="sec6.1"/>, <xref linkend="sec6.6"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/park.refentry
--- a/docs/nitros9guide/park.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/park.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>PARK</command>
+<command>park</command>
 <arg choice="plain">
   <replaceable>device name</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/pmap.refentry
--- a/docs/nitros9guide/pmap.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/pmap.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>PMAP</command>
+<command>pmap</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/printerr.refentry
--- a/docs/nitros9guide/printerr.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/printerr.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,13 +6,13 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>PRINTERR</command>
+<command>printerr</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
 <refsect1><title>Description</title>
 <para>
-This command replaces the basic OS-9 error printing routine (F$PERR
+This command replaces the basic OS-9 error printing routine (F$Perr
 service request) which only prints error code numbers, with a
 routine the reads and displays textual error messages from the file
 <filename>/d0/SYS/errmsg</filename>. Printerr's effect is system-wide.
@@ -25,18 +25,20 @@
 the error message text. The error messages need not be in any
 particular order. Delimiters are spaces or any character numerically lower then
 $20. Any line having a delimiter as its first
-character is considered a contintjation of the previous line(s) which
+character is considered a continuation of the previous line(s) which
 permits multi-line error messages.
 </para>
+<warning>
 <para>
-WARNING: Once the <command>printerr</command> command has been used,
+Once the <command>printerr</command> command has been used,
 it can not be undone. Once
 installed, the <command>printerr</command> module should not be unlinked.
 <command>Printerr</command> uses the current user's stack for an I/O buffer, so users
 are encouraged to reserve reasonably large stacks.
 </para>
+</warning>
 <para>
-For more information see: 4.7, 6.2
+For more information see: <xref linkend="sec4.7"/>, <xref linkend="sec6.2"/>.
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/proc.refentry
--- a/docs/nitros9guide/proc.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/proc.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>PROC</command>
+<command>proc</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -24,7 +24,8 @@
 module, and standard input path.
 </para>
 <para>
-For more information see: 5.1, 5.2, 5.3
+For more information see: <xref linkend="sec5.1"/>,
+<xref linkend="sec5.2"/>, <xref linkend="sec5.3"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/procs.refentry
--- a/docs/nitros9guide/procs.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/procs.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>PROCS</command>
+<command>procs</command>
 <arg choice="opt">
   <option>-e</option>
 </arg>
@@ -27,7 +27,8 @@
 module, and standard input path.
 </para>
 <para>
-For more information see: 5.1, 5.2, 5.3
+For more information see: <xref linkend="sec5.1"/>,
+<xref linkend="sec5.2"/>, <xref linkend="sec5.3"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/pwd.refentry
--- a/docs/nitros9guide/pwd.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/pwd.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,10 +6,10 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>PWD</command>
+<command>pwd</command>
 </cmdsynopsis>
 <cmdsynopsis>
-<command>PXD</command>
+<command>pxd</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/rename.refentry
--- a/docs/nitros9guide/rename.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/rename.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>RENAME</command>
+<command>rename</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/runb.refentry
--- a/docs/nitros9guide/runb.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/runb.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>Runb</command>
+<command>runb</command>
 <arg choice="plain"><replaceable>i-code module</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/save.refentry
--- a/docs/nitros9guide/save.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/save.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>SAVE</command>
+<command>save</command>
 <arg choice="plain">
   <replaceable>path</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/setime.refentry
--- a/docs/nitros9guide/setime.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/setime.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>SETIME</command>
+<command>setime</command>
 <arg choice="opt">y,m,d,h,m,s</arg>
 </cmdsynopsis>
 </refsynopsisdiv>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/setpr.refentry
--- a/docs/nitros9guide/setpr.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/setpr.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>SETPR</command>
+<command>setpr</command>
 <arg choice="plain">
   <replaceable>procID</replaceable>
 </arg>
@@ -28,7 +28,7 @@
 built-in to the <command>shell</command>.
 </para>
 <para>
-For more information see: 5.1, <command>procs</command>
+For more information see: <xref linkend="sec5.1"/>, <command>procs</command>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/shell.refentry
--- a/docs/nitros9guide/shell.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/shell.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>SHELL</command>
+<command>shell</command>
 <arg choice="plain"><replaceable>arglist</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/sleep.refentry
--- a/docs/nitros9guide/sleep.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/sleep.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>SLEEP</command>
+<command>sleep</command>
 <arg choice="plain">
   <replaceable>tickcount</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/smap.refentry
--- a/docs/nitros9guide/smap.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/smap.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>SMAP</command>
+<command>smap</command>
 </cmdsynopsis>
 </refsynopsisdiv>
 
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/tee.refentry
--- a/docs/nitros9guide/tee.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/tee.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>TEE</command>
+<command>tee</command>
 <arg choice="plain">
   &repeatst;<replaceable>path</replaceable>&repeaten;
 </arg>
@@ -16,7 +16,7 @@
 <refsect1><title>Description</title>
 
 <para>
-This command is a filter (see 4.3.3) that copies all text lines from
+This command is a filter (see <xref linkend="sec4.3.3"/>) that copies all text lines from
 its standard input path to the standard output path
 <emphasis>and</emphasis> any number
 of additional output paths whose pathlists are given as parameters.
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/tmode.refentry
--- a/docs/nitros9guide/tmode.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/tmode.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>TMODE</command>
+<command>tmode</command>
 <arg choice="opt">
   .<replaceable>pathnum</replaceable>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/tsmon.refentry
--- a/docs/nitros9guide/tsmon.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/tsmon.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>TSMON</command>
+<command>tsmon</command>
 <arg choice="opt"><replaceable>pathlist</replaceable></arg>
 </cmdsynopsis>
 </refsynopsisdiv>
@@ -22,7 +22,7 @@
 </para>
 <para>
 Note: The <command>login</command> command and its password file must be present for
-<command>tsmon</command> to work correctly (see the <command>login</command> command description).
+<command>tsmon</command> to work correctly (see the <command moreinfo="refentry">login</command> command description).
 </para>
 <refsect2>
 <title>Logging Off the System</title>
@@ -32,7 +32,7 @@
 you off of the system and return control to <command>tsmon</command>.
 </para>
 <para>
-For more information see: 2.5, <command>login</command>
+For more information see: <xref linkend="sec4.9"/>, <command moreinfo="refentry">login</command>
 </para>
 </refsect2>
 </refsect1>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/tuneport.refentry
--- a/docs/nitros9guide/tuneport.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/tuneport.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>TUNEPORT</command>
+<command>tuneport</command>
 <arg choice="opt">
   <option>-s=value</option>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/unlink.refentry
--- a/docs/nitros9guide/unlink.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/unlink.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>UNLINK</command>
+<command>unlink</command>
 <arg choice="plain">
   <replaceable>modname</replaceable>
 </arg>
@@ -34,7 +34,8 @@
 <para>
 
 
-For more information see: 5.4, 5.4.1, 5.4.2
+For more information see: <xref linkend="sec5.4"/>,
+<xref linkend="sec5.4.1"/>, <xref linkend="sec5.4.2"/>
 </para>
 </refsect1>
 <refsect1><title>Examples</title>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/verify.refentry
--- a/docs/nitros9guide/verify.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/verify.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>VERIFY</command>
+<command>verify</command>
 <arg choice="opt">
   <option>-u</option>
 </arg>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/wcreate.refentry
--- a/docs/nitros9guide/wcreate.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/wcreate.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>WCREATE</command>
+<command>wcreate</command>
 <group>
 <arg choice="opt">opts</arg>
 </group>
diff -r f5d45fbe3a76 -r 4dae346c4969 docs/nitros9guide/xmode.refentry
--- a/docs/nitros9guide/xmode.refentry	Sun Apr 06 10:05:54 2003 +0000
+++ b/docs/nitros9guide/xmode.refentry	Mon Apr 07 21:01:46 2003 +0000
@@ -6,7 +6,7 @@
 
 <refsynopsisdiv>
 <cmdsynopsis>
-<command>XMODE</command>
+<command>xmode</command>
 <arg choice="plain"><replaceable>devname</replaceable></arg>
 <arg choice="opt"><replaceable>arglist</replaceable></arg>
 </cmdsynopsis>
@@ -25,7 +25,7 @@
 open paths so its effect is temporary. <command>Xmode</command> actually updates the
 device descriptor so the change persists as long as the computer is
 running, even if paths to the device are repetitively opened and
-closed. If <command>xmode</command> is used to change parameter(s) and the COBBLER
+closed. If <command>xmode</command> is used to change parameter(s) and the <command>cobbler</command>
 program is used to make a new system disk, the changed parameter
 will be permanently reflected on the new system disk.
 </para>