Mercurial > hg > Members > kono > nitros9-code
changeset 159:828d64d27e63
Changed go51 from an appendix to a refentry
Moved go51 into the commands section.
author | roug |
---|---|
date | Mon, 08 Jul 2002 07:58:17 +0000 |
parents | f04c81aa1759 |
children | 0bdd24a428fb |
files | docs/nitros9guide/chap7.chapter docs/nitros9guide/go51.refentry docs/nitros9guide/intro.preface docs/nitros9guide/os9guide.docbook docs/nitros9guide/preface-dragon.preface |
diffstat | 5 files changed, 240 insertions(+), 88 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/nitros9guide/chap7.chapter Sun Jul 07 21:17:01 2002 +0000 +++ b/docs/nitros9guide/chap7.chapter Mon Jul 08 07:58:17 2002 +0000 @@ -100,6 +100,7 @@ &exref; &formatref; &freeref; +&go51ref; &helpref; &identref; &inizref;
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/go51.refentry Mon Jul 08 07:58:17 2002 +0000 @@ -0,0 +1,151 @@ +<refentry id="go51"> +<refnamediv> +<refname>GO51</refname> +<refpurpose>The 51 Column by 24 Line Video Display</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis> +<command>GO51</command> +</cmdsynopsis> +</refsynopsisdiv> + +<refsect1><title>Description</title> +<para> +An alternative video screen device driver, which provides a 51 +column by 24 line display with upper and lower case character sets, +can be incorporated into OS-9 with the command: +<screen> +GO51 +</screen> +This command replaces the normal text screen driver with one that +uses high resolution graphics to "draw" the characters. As there +are fewer pixels (dots) per character in this mode more characters +can be displayed on the screen, albeit with some loss of character +definition. +</para> +<para> +Note, however, that the use of a high resolution graphics page +means that an extra 6K bytes will be needed in this mode. This +extra memory requirement is not normally a problem but in memory-critical +applications, such as the C and Pascal compilers, the user +can simply avoid the use of GO51. +</para> +<para> +This mode of display has a set of <emphasis>escape sequences</emphasis> +(commands) to +emulate commercial data terminals. In addition to the video screen +driver, GO51 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. +</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 +control the display. These functions are activated by the use of +the various escape sequences and control characters described below: +</para> +<informaltable frame="none"> +<tgroup cols="2"> +<colspec colwidth="1.5in"> +<colspec colwidth="3.5in"> +<thead> +<row> +<entry>Escape Sequence (Hex)</entry> +<entry>Name/Function</entry> +</row> +</thead> + +<tbody> +<row> +<entry>1B 41 X Y</entry> +<entry>CURSOR XY - move cursor to column X(0-50) +and Y(0-23) where X and Y are single byte values.</entry> +</row> +<row> +<entry>1B 42</entry> +<entry>CLEAR EOL - clear from cursor to the end of +line. Cursor position remains unchanged.</entry> +</row> +<row> +<entry>1B 43</entry> +<entry>CURSOR RIGHT - move cursor right by one character position.</entry> +</row> +<row> +<entry>1B 44</entry> +<entry>CURSOR UP - move cursor up by one line.</entry> +</row> +<row> +<entry>1B 45</entry> +<entry>CURSOR DOWN - move cursor down one line.</entry> +</row> +<row> +<entry>1B 46</entry> +<entry>REVERSE ON - turn reverse field on.</entry> +</row> +<row> +<entry>1B 47</entry> +<entry>REVERSE OFF - turn reverse field off.</entry> +</row> +<row> +<entry>1B 48</entry> +<entry>UNDERLINE ON - turn underline on.</entry> +</row> +<row> +<entry>1B 49</entry> +<entry>UNDERLINE OFF - turn underline off.</entry> +</row> +<row> +<entry>1B 4A</entry> +<entry>CLEAR EOS - clear from cursor to end of +screen. Cursor position remains unchanged.</entry> +</row> +</tbody> +</tgroup> +</informaltable> + + + + +<informaltable frame="none"> +<tgroup cols="2"> +<colspec colwidth="1.5in"> +<colspec colwidth="3.5in"> +<thead> +<row> +<entry>Control Character (Hex)</entry> +<entry>Name/Function</entry> +</row> +</thead> +<tbody> +<row> +<entry>07</entry> +<entry>BELL - generates a short audible tone.</entry> +</row> +<row> +<entry>08</entry> +<entry>BACKSPACE (CURSOR LEFT) - moves cursor left one character position.</entry> +</row> +<row> +<entry>0A</entry> +<entry>LINE FEED - move cursor down by one line.</entry> +</row> +<row> +<entry>0B</entry> +<entry>CURSOR HOME - move cursor to home position 0,0 (top left).</entry> +</row> +<row> +<entry>0C</entry> +<entry>CLEAR SCREEN - clears the screen and home cursor.</entry> +</row> +</tbody> +</tgroup> +</informaltable> +<note><para> +The GO51 device driver is only available on Dragon Computers. +</para></note> +</refsect1> +</refentry>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/nitros9guide/intro.preface Mon Jul 08 07:58:17 2002 +0000 @@ -0,0 +1,84 @@ +<preface> +<title>Welcome to OS-9!</title> +<titleabbrev>Introduction</titleabbrev> +<para> +The heart of your &make; Computer is an amazing device: the +6809 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 microcomputer, together +they provide an extremely efficient and powerful combination. +</para> +<para> +The foundation of a computer's software system is its +<emphasis>Operating System</emphasis> or "OS". It is the master control +program that interfaces all other software to the system's hardware. Some +of the things it must do are performing input and output operations, +coordinating memory use, and many other "housekeeping" functions. All +other software - programming languages, applications programs, etc. - +live in your computer's memory along with the OS and depend on it to +communicate with you using the keyboard and display and to store and +retrieve data on disks, etc. Because virtually all other software relies +on the OS, your computer's performance depends on the capabilities and +efficiency of its OS. +</para> + +<para> +OS-9's overall structure was based on the famous UNIX<footnote id="unixdesc"> +<para> +Unix is an operating system designed by Bell Telephone +Laboratories, which is becoming widely recognized as a standard for +mini and micro operating systems because of its versatility and +elegant structure. +</para> +</footnote> +operating system, which has been widely acclaimed as the operating +system of the future because of its versatility, logical structure, +and friendly user commands. The OS-9 family of advanced software is +not only more powerful than most other microcomputer scftware - it +is also much easier to learn and use. +</para> +<para> +Some of the advanced OS-9 features you'll learn about in this +book are: +</para> +<orderedlist numeration="arabic"> + +<listitem><para>Friendly Unix<footnoteref linkend="unixdesc">-type +user interface and environment</para></listitem> + +<listitem><para>Multiuser/Multitasking Real-Time Operating System</para></listitem> + +<listitem><para>Extensive support for structured, modular programming</para></listitem> + +<listitem><para>Device-independent interrupt-driven input/output system</para></listitem> + +<listitem><para>Multi-level directory file system</para></listitem> + +<listitem><para>Fast Random-Access File System</para></listitem> + +<listitem><para>Readily Expandable and Adaptable Design</para></listitem> + +</orderedlist> +<para> +If you don't know what some of these thing mean yet - don't +worry. As you explore OS-9 you'll soon learn how they enhance the +capability of your &make; Computer and make it so much easier to use +in almost any application. +</para> +<para> +OS-9 has many commands and functions - definitely more than +you can learn in an evening! The best way to become an OS-9 expert +is to study this manual carefully, section-by-section, taking tire +to try out each command or function. Because many functions affect +others, you'll find this manual extensively cross-referenced so you +can skip ahead to help you understand a new topic. Taking the time +to study this book will certainly increase your knowledge and +enjoyment of OS-9. +</para> +<para> +But if you can't wait, at least read the rest of this chapter, +scan the command descriptions in Chapter 7, and have fun +experimenting! +</para> +</preface>
--- a/docs/nitros9guide/os9guide.docbook Sun Jul 07 21:17:01 2002 +0000 +++ b/docs/nitros9guide/os9guide.docbook Mon Jul 08 07:58:17 2002 +0000 @@ -3,9 +3,9 @@ <!ENTITY replend ">"> <!ENTITY repeatst "{"> <!ENTITY repeaten "}"> - <!ENTITY vendor "Dragon Data"> + <!ENTITY vendor "OS9 Consortium"> <!ENTITY make "Dragon/Color"> - <!ENTITY preface SYSTEM "preface-dragon.preface"> + <!ENTITY preface SYSTEM "intro.preface"> <!ENTITY chap1 SYSTEM "chap1.chapter"> <!ENTITY chap2 SYSTEM "chap2.chapter"> <!ENTITY chap3 SYSTEM "chap3.chapter"> @@ -41,6 +41,7 @@ <!ENTITY exref SYSTEM "ex.refentry"> <!ENTITY formatref SYSTEM "format.refentry"> <!ENTITY freeref SYSTEM "free.refentry"> + <!ENTITY go51ref SYSTEM "go51.refentry"> <!ENTITY helpref SYSTEM "help.refentry"> <!ENTITY identref SYSTEM "ident.refentry"> <!ENTITY inizref SYSTEM "iniz.refentry"> @@ -74,6 +75,7 @@ <book id="os9guide" lang="en"> <bookinfo> <title>OS-9 Operating System User's Guide</title> + <subtitle>Updated for the new millenium</subtitle> <publisher> <publishername>Cleglen Publishing Limited</publishername> @@ -103,11 +105,9 @@ &chap5; &chap6; &chap7; -&commandsapp; &errorcodesapp; &displayapp; &keysapp; -&go51app; &acia51app; </book>
--- a/docs/nitros9guide/preface-dragon.preface Sun Jul 07 21:17:01 2002 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,84 +0,0 @@ -<preface> -<title>Welcome to OS-9!</title> -<titleabbrev>Introduction</titleabbrev> -<para> -The heart of your &make; Computer is an amazing device: the -6809 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 microcomputer, together -they provide an extremely efficient and powerful combination. -</para> -<para> -The foundation of a computer's software system is its -<emphasis>Operating System</emphasis> or "OS". It is the master control -program that interfaces all other software to the system's hardware. Some -of the things it must do are performing input and output operations, -coordinating memory use, and many other "housekeeping" functions. All -other software - programming languages, applications programs, etc. - -live in your computer's memory along with the OS and depend on it to -communicate with you using the keyboard and display and to store and -retrieve data on disks, etc. Because virtually all other software relies -on the OS, your computer's performance depends on the capabilities and -efficiency of its OS. -</para> - -<para> -OS-9's overall structure was based on the famous UNIX<footnote id="unixdesc"> -<para> -Unix is an operating system designed by Bell Telephone -Laboratories, which is becoming widely recognized as a standard for -mini and micro operating systems because of its versatility and -elegant structure. -</para> -</footnote> -operating system, which has been widely acclaimed as the operating -system of the future because of its versatility, logical structure, -and friendly user commands. The OS-9 family of advanced software is -not only more powerful than most other microcomputer scftware - it -is also much easier to learn and use. -</para> -<para> -Some of the advanced OS-9 features you'll learn about in this -book are: -</para> -<orderedlist numeration="arabic"> - -<listitem><para>Friendly Unix<footnoteref linkend="unixdesc">-type -user interface and environment</para></listitem> - -<listitem><para>Multiuser/Multitasking Real-Time Operating System</para></listitem> - -<listitem><para>Extensive support for structured, modular programming</para></listitem> - -<listitem><para>Device-independent interrupt-driven input/output system</para></listitem> - -<listitem><para>Multi-level directory file system</para></listitem> - -<listitem><para>Fast Random-Access File System</para></listitem> - -<listitem><para>Readily Expandable and Adaptable Design</para></listitem> - -</orderedlist> -<para> -If you don't know what some of these thing mean yet - don't -worry. As you explore OS-9 you'll soon learn how they enhance the -capability of your &make; Computer and make it so much easier to use -in almost any application. -</para> -<para> -OS-9 has many commands and functions - definitely more than -you can learn in an evening! The best way to become an OS-9 expert -is to study this manual carefully, section-by-section, taking tire -to try out each command or function. Because many functions affect -others, you'll find this manual extensively cross-referenced so you -can skip ahead to help you understand a new topic. Taking the time -to study this book will certainly increase your knowledge and -enjoyment of OS-9. -</para> -<para> -But if you can't wait, at least read the rest of this chapter, -scan the command descriptions in Chapter 7, and have fun -experimenting! -</para> -</preface>