home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / latrobe / t / typtut.exe / TTYPE.TXT < prev    next >
Text File  |  1990-10-31  |  8KB  |  234 lines
  1.                        TOUCHTYPE TUTOR
  2.  
  3.                    DEC Rainbow 100  Version
  4.                     Revised Oct. 29, 1990
  5.  
  6.  
  7.             Concept By: Tim Pearce   7 Bannerman St,
  8.                                      Cremorne, N.S.W.
  9.    
  10.            Reworked By: R. Berthet   15/5 Cottonwood Cr.
  11.                                      North Ryde, 2113.
  12.                                      SYDNEY.
  13.                                      (61-2)-88-1640
  14.  
  15.            Customized for DEC Rainbow 100 and made code
  16.                more portable by:     Harvey G. Lord
  17.                                      P.O. Box 183
  18.                                      Storrs, CT  06268
  19.  
  20.            Completely reworked into  Carl Neiburger
  21.             TurboPascal version for  169 N. 25th St.
  22.                     DEC Rainbow by:  San Jose, Calif. 95116
  23.  
  24. These instructions are rewritten by Carl Neiburger from an earlier 
  25. draft by Richard Berthet. They remain public domain.
  26.  
  27. INTRODUCTION
  28.  
  29. TTYPE  (TOUCHTYPE TUTOR) is what it says it is: a typing tutor.
  30.  
  31. The original was written in BASIC.  It has been reworked into Turbo Pascal
  32. so that DEC Rainbow owners who do not have BASIC can run it and to add 
  33. some speed and improvements available from a modern compiler.
  34.  
  35. Some of the features are:
  36.  
  37. *    Five HELP files, which you can edit and expand.
  38.  
  39. *    Onscreen representation of a 'QWERTY' keyboard, which displays 
  40.      the keys to be type and those actually typed.
  41.  
  42. *    Graduated exercises with prompts (or comments) throughout.
  43.  
  44. When you unpack TTYPE, you should have these files:
  45.  
  46.     TTYPE.TXT      These instructions
  47.     TTYPE.EXE      The program
  48.     TTYPE.PAS      The source code
  49.  
  50.     TTHELP0.DAT  |
  51.     .. to ..     | The help files -- All must be on default drive
  52.     TTHELP4.DAT  |
  53.  
  54.     TTYPEXA.DAT  | EXERCISE Data files -- All that you wish 
  55.     .. to ..     | to use must be on default drive.
  56.     TTYPEXJ.DAT  | You can create more.
  57.     
  58.     WARNING.RSI  | Important information about a health-hazard
  59.                  | linked to touch typing.
  60.  
  61. All you need to run TTYPE is to put TTYPE.EXE in your default 
  62. directory or a directory reachable with your current path, and 
  63. put all of the *.DAT files in your current directory.
  64.  
  65. Then start the program by entering TTYPE.  There are no command tails.
  66. The HELP files include all you need to know to run the program, and 
  67. they are displayed automatically.
  68.  
  69. Before you start TTYPE, though PLEASE READ WARNING.RSI for information 
  70. on good typing habits that can spare you serious harm.
  71.  
  72. TO AUGMENT THE EXERCISES AND MODIFY THE HELP FILES
  73. ==================================================
  74.  
  75. Both the exercises and the help files are designed to be created and 
  76. modified easily using any text editor capable of saving text in 
  77. ASCII form.
  78.  
  79. EXERCISE FILES
  80. ==============
  81.  
  82. These files are named TTYPEX? .DAT, where ? must be a letter between 
  83. "A" and "Z".  TTYPE does a directory search for all such files in the 
  84. default path.
  85.  
  86. --  Comments are groups of FIVE lines, each beginning with !#.
  87.     Note that comments MUST be in groups of five consecutive lines.
  88.     If you don't need that many lines, leave some blank.
  89.  
  90. --  Lines beginning with |n, where n is a single digit number, are 
  91.     repeated n times.
  92.  
  93. --  A paragraph is a group of lines that is to be repeated in order.
  94.     In other words, instead of repeating a single line n times, 
  95.     you repeat the sequence n times.
  96.  
  97.     The first line of a paragraph defines its length and the number 
  98.     of repeats.  It consists only of |pn,ll, where "|p" or "|P" are 
  99.     literal characters, n is a single-digit number of repeats, and 
  100.     ll is a double-digit number of up to 20 lines.
  101.  
  102.     This introducer is followed by ll lines, all of which are typed
  103.     exactly as they should appear.
  104.  
  105. --  All other lines are treated as normal exercise lines, to be typed
  106.     once.
  107.  
  108. --  No exercise line may be longer than 80 characters, including the 
  109.     | or !# introductory codes.
  110.     
  111. EXAMPLE OF AN EXERCISE FILE
  112.  
  113. !#Exercise A. 
  114. !#  
  115. !#        Left hand on the [A] [S] [D] [F] keys.
  116. !#
  117. !#        Right hand on the [J] [K] [L] [;] keys.
  118. |3fff fff jjj jjj fff jjj ff jj ff jj f j
  119. |3ddd ddd kkk kkk ddd kkk dd kk dd kk d k
  120. !#
  121. !#
  122. !#        RETURN the carriage without looking up.
  123. !#
  124. !#
  125. |3sss sss lll lll sss lll ss ll ss ll s l
  126. |3aaa aaa ;;; ;;; aaa ;;; aa ;; aa ;; a ;
  127. |2aaa ddd add add aaa lll all all add all
  128. |3aaa sss kkk ask jjj aaa lll jal ask jal
  129. |3ddd aaa aaa dad lll aaa ddd lad dad lad
  130. |3a as ask asks asks; f fa fal fall falls
  131. |3a al ala alas alas; f fl fla flas flask
  132. |3a ad add adds adds; s sa sal sala salad
  133. !#
  134. !#
  135. !#        GOAL: Finish next two lines in one minute.
  136. !#
  137. !#
  138. |2a sad fad; a lass falls; dad asks a lad;
  139.  
  140. HELP FILES
  141. ==========
  142.  
  143. The current version of TTYPE has only five help files, numbered 
  144. TTHELP0 .DAT through TTHELP4 .DAT.  The text of each may be 
  145. modified.
  146.  
  147. One special character, #, on a single line, creates a page break.
  148. You should include a message like "Hit RETURN for more HELP." on 
  149. the line preceding it.
  150.  
  151. At the end of each HELP file, the user must be prompted for an 
  152. appropriate response.  The response characters are identical to 
  153. those in the menus within the program, so the HELP files act as 
  154. expanded menus.  In other words, typing "Y" at the end of a help 
  155. file has the same effect as typing "Y" in the menu that called it.
  156.  
  157. Here is TTHELP4.DAT:
  158.  
  159.  
  160.                    You have these options:
  161.  
  162.     C - Reset score counters and remain in "escape mode."
  163.  
  164.     N - Start a new exercise.
  165.  
  166.     R - Repeat the current line or paragraph once more. (Note: The lesson 
  167.         plan may already call for several repeats.  Pressing R will increase 
  168.         that number.
  169.  
  170.     S - Skip up to nine lines -- you will be asked how many.  Any response 
  171.         other than "1" to "9" will be interpreted as zero.  When you choose 
  172.         this option, you will remain in "escape mode."
  173.  
  174.     Q - Quit TYPING TUTOR and return to the MS-DOS prompt.
  175.  
  176.     <RETURN> - To continue exercise where you left off.
  177.  
  178.  
  179.  
  180.  
  181.  
  182. HIT any of these keys.
  183. ---------------------
  184.  
  185. THE SOURCE CODE:
  186. ===============
  187.  
  188. Richard Berthet made these comments about part of the earlier BASIC 
  189. version of the source code:
  190.  
  191.     My first reaction upon reading this code was unprintable; it 
  192.     still is.  I haven't done much to it, apart from annotations, 
  193.     because  the flow is so tortuous that any changes cause it to 
  194.     bomb. Anyway, it works, even if it is messy !
  195.  
  196. Because I don't have a BASIC compiler around -- and wouldn't want one
  197. -- I did something about the mess by rewriting the whole thing in 
  198. Turbo Pascal.  This wasn't as hard as it may seem, because eliminating 
  199. the spaghetti code and leaving out procedures that are part of standard 
  200. libraries shortened the code from 748 to about 550 lines, including a 
  201. picture and map of the keyboard (originally, in a cruder form, was in 
  202. a data file), and a few extra lines of introduction.
  203.  
  204. I didn't do a very thorough job of polishing code, and improvements 
  205. are undoubtedly possible.
  206.  
  207. Although the code is now Rainbow-specific, it should be fairly easy to 
  208. port to any other machine.  All that needs to be done is this:
  209.  
  210.     -- Change the outline characters the keyboard from VT100 characters 
  211.        to whatever works on your machine and reassign any keys that 
  212.        need to be moved.  You must also revise CharIndexType to 
  213.        include the right character addresses (one character to the 
  214.        left of each letter, because the spaces to either side of it 
  215.        are also highlighted), and ShowKey to modify the addresses 
  216.        of the space bar and Return key.
  217.  
  218.     -- Substitute versions of ShowLine, SetAttribute, GotoXY, ClrScr 
  219.        and EraseLine that work on your machine.  For IBM PCs, 
  220.        Brian Foley's FastWr.PAS offers the equivalent of ShowLine 
  221.        and SetAttribute.  Turbo Pascal has GotoXY and ClrScr in its 
  222.        CRT unit.  EraseLine is trickier.  Here is a routine that 
  223.        will work using procedures in the CRT unit:
  224.  
  225.          PROCEDURE EraseLine;
  226.          VAR x, y: CARDINAL;
  227.          BEGIN
  228.               x := WhereX;
  229.               y := WhereY;
  230.               GotoXY(1, y);
  231.               ClrEOL;
  232.               GotoXY(x, y);
  233.          END;
  234.