# HG changeset patch # User roug # Date 1046808350 0 # Node ID d9ed9d44b70cf64a5770ee010f59da0ec5db9441 # Parent 15a1a20b70abcd629db74dcf2107be0e4ab36c70 Some character entities had missing semicolons. It's &CPU; The os9l1guide and os9l2guide are now much more modular simply because the sections that are not to be included in one of them is defined as the empty string in the -BINEX / EXBIN -Convert Binary To S-Record File / Convert S-Record To Binary File +BINEX +Convert Binary To S-Record File @@ -10,11 +10,6 @@ path1 path2 - - EXBIN - path2 - path1 - Description @@ -52,22 +47,6 @@ list scanner.S1 >/T1 - -EXBIN is the inverse operation; "path1" is assumed to be a -S-Record format text file which EXBIN converts to pure binary form on -a new file called "path2". The load addresses of each data record -must describe continguous data in ascending order. - - -EXBIN does not generate or check for the proper OS-9 module -headers or CRC check value required to actually load the binary -file. The IDENT or VERIFY commands can be used to check the -validity of the modules if they are to be loaded or run. -Example: - - -exbin program.S1 cmds/program - diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/chap1.chapter --- a/docs/nitros9guide/chap1.chapter Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/chap1.chapter Tue Mar 04 20:05:50 2003 +0000 @@ -4,10 +4,10 @@
What You Need to Run OS-9 -&os9level &os9version has been tailored to run on the &make;. To use it you'll need the following things: +&os9level; &os9version; has been tailored to run on the &make;. To use it you'll need the following things: - A &minmem &make; + A &minmem; &make; A Disk Drive With Contoller Cartridge An OS-9 &make; System Disk @@ -34,7 +34,7 @@ Insert the OS-9 System Disk in drive zero and close the door. -Type "&DOSCMD". After a few seconds of disk activity you should +Type "&DOSCMD;". After a few seconds of disk activity you should see a screen with the words "OS9 BOOT". OS-9 will then begin @@ -50,15 +50,15 @@ In Case You Have Problems Starting OS-9 If BASIC gives an error message after you -type "&DOSCMD", remove the +type "&DOSCMD;", remove the disk, turn the computer off and on, then try again. If this repeatedly fails your OS-9 diskette may be bad. Did you remember to turn the disk drive power switch on? -Does your &make; have &minmem RAM? This is a must! +Does your &make; have &minmem; RAM? This is a must! -If your &make; doesn't seem to understand the &DOSCMD command, your controller has DOS 1.0. You will need to upgrade to +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. If the "OS9 BOOT message is displayed but nothing else happens, @@ -113,7 +113,7 @@ OS9Boot startup CMDS SYS DEFS -The file "OS9Boot" contains the OS-9 program in &CPU machine +The file "OS9Boot" contains the OS-9 program in &CPU; machine language, which was loaded into memory during the bootstrap operation. diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/chap2.chapter --- a/docs/nitros9guide/chap2.chapter Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/chap2.chapter Tue Mar 04 20:05:50 2003 +0000 @@ -83,7 +83,7 @@
Sending Output to the Printer -Normally, most commands and programs display output on the &make video display. The output of these programs can +Normally, most commands and programs display output on the &make; video display. The output of these programs can alternatively be printed by specifying output redirection on the command line. This is done by including the following modifier to at the end of any command line: @@ -289,7 +289,7 @@ Two keys are used in combination with other keys to change their meaning. The SHIFT KEY selects between upper case and lower case -letters or punctuation, and the &ctrlkey key can be used to generate +letters or punctuation, and the &ctrlkey; key can be used to generate control characters. @@ -310,9 +310,9 @@ There are a number of useful control functions that can be generated from the keyboard. Many of these functions use "control -keys" which are generated by simultaneously depressing the &ctrlkey key +keys" which are generated by simultaneously depressing the &ctrlkey; key plus some other key. For example, to generate the character for -CONTROL D press the &ctrlkey and D keys at the same time. +CONTROL D press the &ctrlkey; and D keys at the same time. diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/chap4.chapter --- a/docs/nitros9guide/chap4.chapter Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/chap4.chapter Tue Mar 04 20:05:50 2003 +0000 @@ -644,7 +644,7 @@ Running Compiled Intermediate Code Programs Before the shell executes a program, it checks the program -module's language type. If its type is not &CPU machine language, +module's language type. If its type is not &CPU; machine language, shell will call the appropriate run-time system for that module. Versions of the shell supplied for various systems are capable of calling different run-time systems. Most versions of shell call diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/chap5.chapter --- a/docs/nitros9guide/chap5.chapter Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/chap5.chapter Tue Mar 04 20:05:50 2003 +0000 @@ -295,7 +295,7 @@ When performing a fork operation, OS-9's first step is to attempt to locate the requested program module by searching the "module directory", which has the address of every module present in memory. -The &CPU instruction set supports a type of program called +The &CPU; instruction set supports a type of program called "reentrant code" which means the exact same "copy" of a program can be shared by two or more different processes simultaneously without affecting each other, provided that each "incarnation" of the @@ -400,7 +400,7 @@ specific, predetermined memory addresses to work correctly, and can therefore be loaded at different memory addresses at different times. PIC programs require special types of machine language instructions -which few computers have. The ability of the &CPU +which few computers have. The ability of the &CPU; microprocessor to use this type of program is one of its most powerful features. diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/chap7.chapter --- a/docs/nitros9guide/chap7.chapter Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/chap7.chapter Tue Mar 04 20:05:50 2003 +0000 @@ -79,6 +79,7 @@
Commands +&asmref; &attrref; &backupref; &binexref; @@ -104,6 +105,7 @@ &dumpref; &echoref; &exref; +&exbinref; &exmoderef; &formatref; &freeref; @@ -121,6 +123,7 @@ &mergeref; &mfreeref; &os9genref; +&procref; &procsref; &pwdref; &renameref; @@ -130,12 +133,14 @@ &setprref; &shellref; &sleepref; +&smapref; &teeref; &tmoderef; &tsmonref; &tuneportref; &unlinkref; &verifyref; +&wcreateref; &xmoderef;
diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/deiniz.refentry --- a/docs/nitros9guide/deiniz.refentry Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/deiniz.refentry Tue Mar 04 20:05:50 2003 +0000 @@ -36,7 +36,7 @@
-Notes: +Notes Do not deiniz a module unless you have explicitly iniz-ed it. If you do deiniz a device that you have not @@ -46,7 +46,7 @@ -Example: +Example DEINIZ P T2 [ENTER] diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/devs.refentry --- a/docs/nitros9guide/devs.refentry Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/devs.refentry Tue Mar 04 20:05:50 2003 +0000 @@ -12,7 +12,45 @@ Description -Show device table entries. +Devs displays a list of the system's device table. The device table contains an +entry for each active device known to OS-9. devs does not display information +for uninitialized devices. The devs display header lists the system name, +the OS-9 version number, and the maximum number of devices allowed in the device table. + + +Each line in the devs display contains five fields: + + + + +NameDescription + + + + +DeviceName of the device descriptor + + +DriverName of the device driver + + +File MgrName of the file manager + + +Data PtrAddress of the device driver's static storage + + +LinksDevice use count + + + + + + +Each time a user executes a chd to an RBF device, the use count of that device +is incremented by one. Consequently, the Links field may be artificially high. + + diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/display.appendix --- a/docs/nitros9guide/display.appendix Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/display.appendix Tue Mar 04 20:05:50 2003 +0000 @@ -4,7 +4,7 @@
The Video Display Generator -&os9level allows the VDG display to be used in +&os9level; allows the VDG display to be used in alphanumeric, semigraphic, and graphics modes. There are many built-in functions to control the display, which are activated by used of various ASCII control character. Thus, these functions are diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/exbin.refentry --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/exbin.refentry Tue Mar 04 20:05:50 2003 +0000 @@ -0,0 +1,44 @@ + + +EXBIN +Convert S-Record To Binary File + + + + + EXBIN + path2 + path1 + + + +Description + +S-Record files are a type of text file that contains records that +represent binary data in hexadecimal character form. This +Motorola-standard format is often directly accepted by commercial PROM +programmers, emulators, logic analyzers and similar devices that are +interfaced RS-232 interfaces. It can also be useful for +transmitting files over data links that can only handle character-type +data; or to convert OS-9 assembler or compiler-generated +programs to load on non-OS-9 systems. + + +"Path1" is assumed to be an +S-Record format text file which EXBIN converts to pure binary form on +a new file called "path2". The load addresses of each data record +must describe continguous data in ascending order. + + +EXBIN does not generate or check for the proper OS-9 module +headers or CRC check value required to actually load the binary +file. The IDENT or VERIFY commands can be used to check the +validity of the modules if they are to be loaded or run. +Example: + + +exbin program.S1 cmds/program + + + + diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/intro.preface --- a/docs/nitros9guide/intro.preface Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/intro.preface Tue Mar 04 20:05:50 2003 +0000 @@ -3,7 +3,7 @@ Introduction The heart of your &make; is an amazing device: the -&CPU microprocessor chip. This advanced microcomputer can run the +&CPU; microprocessor chip. This advanced microcomputer can run the kind of sophisticated software normally found only on much larger and costly computers. Because the OS-9 operating system was designed by the same people who designed the 6809 microprocessor, together diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/irqs.refentry --- a/docs/nitros9guide/irqs.refentry Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/irqs.refentry Tue Mar 04 20:05:50 2003 +0000 @@ -12,7 +12,13 @@ Description -Show interrupt polling table. +Irqs displays a list of the system's IRQ polling table. The IRQ polling table contains a +list of the service routines for each interrupt handler known by the system. + + +The irqs display header lists the system name, the OS-9 version number, the maximum +number of devices allowed in the device table, and the maximum number of entries in +the IRQ table. diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/nitros9guide.book --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/nitros9guide.book Tue Mar 04 20:05:50 2003 +0000 @@ -0,0 +1,41 @@ + + &os9level; Operating System User's Guide + &os9version; + + + 2003 + &vendor; + + + + All Rights Reserved. + + + + + Org. + 1983 + Original OS-9 Level One Guide + + + A + March 2003 + Updated with the changes made by Boisy Pitre + + + + + +&preface; +&chap1; +&chap2; +&chap3; +&chap4; +&chap5; +&chap6; +&chap7; +&errorcodesapp; +&displayapp; +&keysapp; +&acia51app; + diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/nitros9l1guide.docbook --- a/docs/nitros9guide/nitros9l1guide.docbook Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/nitros9l1guide.docbook Tue Mar 04 20:05:50 2003 +0000 @@ -11,6 +11,7 @@ + @@ -22,9 +23,9 @@ - + @@ -52,6 +53,7 @@ + @@ -71,6 +73,7 @@ + @@ -80,50 +83,16 @@ + + ]> - - OS-9 Operating System User's Guide - for OS-9 Level One - - - 1983 - Dragon Data Ltd., and Microware Systems Corporation. - - - - All Rights Reserved. Reproduced under license from -Microware Systems Corporation. - - - - -C -March 2003 -Updated with the changes made by Boisy Pitre - - - - - -&preface; -&chap1; -&chap2; -&chap3; -&chap4; -&chap5; -&chap6; -&chap7; -&errorcodesapp; -&displayapp; -&keysapp; -&acia51app; - +&os9guide; diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/nitros9l2guide.docbook --- a/docs/nitros9guide/nitros9l2guide.docbook Tue Mar 04 15:18:51 2003 +0000 +++ b/docs/nitros9guide/nitros9l2guide.docbook Tue Mar 04 20:05:50 2003 +0000 @@ -11,6 +11,7 @@ + @@ -22,6 +23,7 @@ + @@ -53,6 +55,7 @@ + @@ -74,7 +77,7 @@ - + @@ -96,39 +99,5 @@ ]> - - &os9level Operating System User's Guide - &os9version - - - 2003 - &vendor - - - - All Rights Reserved. - - - - -A -March 2003 -Updated with the changes made by Boisy Pitre - - - - - -&preface; -&chap1; -&chap2; -&chap3; -&chap4; -&chap5; -&chap6; -&chap7; -&errorcodesapp; -&displayapp; -&keysapp; - +&os9guide; diff -r 15a1a20b70ab -r d9ed9d44b70c docs/nitros9guide/wcreate.refentry --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/wcreate.refentry Tue Mar 04 20:05:50 2003 +0000 @@ -0,0 +1,35 @@ + + +WCREATE +Initialize and create windows + + + + +WCREATE + +opts + + + +/wX +-s=type +xpos +ypos +xsiz +ysiz +fcol +bcol +bord + + + + +Options + + -? = display help + -z = read command lines from stdin + -s=type = set screen type for a window on a new screen + + +