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 &quot;draw&quot; 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   "&gt;">
   <!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>