Mercurial > hg > Members > kono > nitros9-code
changeset 1093:4dae346c4969
Added crossreferences and lowercased synopsises
line wrap: on
line diff
--- 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">>list</arg>
--- 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>
--- 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
--- 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>
--- 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>
--- 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>
--- 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>
--- 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 "OS9 BOOT" 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
--- 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 @@ >/p </screen> <para> -The ">" character tells the shell to redirect output (See 4.3.2) to +The ">" 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 "/P" (See 3.2). For example, to redirect the output of the +name "/P" (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 "/TERM". @@ -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
--- 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 "opened"), 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 "working directories" associated @@ -508,7 +508,7 @@ directory". 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 @@ "read" 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 ("lines") 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 "d" attribute being set (see 3.8.1). The +can be identified by the "d" 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 "file descriptor sector", which contains a complete description of the file including:
--- 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 "&" 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 "!" 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>
--- 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>
--- 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>
--- 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;
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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
--- 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>
--- 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>
--- 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>
--- 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
--- 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>
--- 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>
--- 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>
--- 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>
--- 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 "Message-of-the-Day"</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>
--- 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>
--- 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 \
--- 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>
--- 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>
--- 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>
--- 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">
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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.
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>
--- 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>