home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 100 / 50 / read.me < prev    next >
Text File  |  1985-09-14  |  32KB  |  663 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                 The Learn System, Version 0.6
  15.                                 For IBM PC and 100% Compatables
  16.                                 Second Draft, 05/01/1985
  17.  
  18.                                 (c)Copyright 1985 Percy Keeley
  19.                                 All Rights Reserved.
  20.  
  21.  
  22.  
  23.                                 Keeley Information
  24.                                 Post Office Box 23388
  25.                                 Honolulu, Hawaii 96822
  26.  
  27. Introduction
  28.  
  29. The LEARN system is a set of programs design to be aids in the creation 
  30. and use of computer-aided-instruction(CAI) courses. The proper use of 
  31. these programs is based on an assumption that the course author(s) want to 
  32. create text screen images which are linked together by a logical 
  33. relationship and driven by the student understanding of the material 
  34. presented. The design of the LEARN system includes components which allow 
  35. the creation of a viewable screen of text (much like designing the layout 
  36. of a single page for a book), the specification of logic to control the 
  37. display of specific screens, and a component to present the resulting CAI 
  38. course to the student.
  39.  
  40. Component One is the EDANSI (edit ANSI screens) program. Users are allowed 
  41. to enter a subset of the American National Standards Institute (ANSI) 
  42. control sequences for screen formating and display. These ANSI control 
  43. functions allow the control of the screen cursor positioning, reassignment 
  44. of the meaning of any key on the keyboard, control of screen display 
  45. attributes (like screen width, color, and alphanumeric/graphics mode 
  46. selection). PC-DOS and MS-DOS versions 2.0 and above have device drivers 
  47. which support the ANSI mode (the driver must be "installed" in order to be 
  48. used). The ANSI extended screen and keyboard control functions are 
  49. activated when DOS is booted up and a "CONFIG.SYS" exists in the root 
  50. directory with a "DEVICE=ANSI.SYS" command in it. Please refer to your 
  51. DOS  Manual for details on using the "CONFIG.SYS" file for configure your 
  52. system.
  53.  
  54. Component Two is the LSCAN (lesson conversion scan) program. LSCAN accepts 
  55. as input a command file created by any word processing program and the 
  56. screen images created by EDANSI to produce a CAI file. LSCAN checks each 
  57. command line for valid syntax, and converts it to a CAI format suitable 
  58. for use by the LEARN program.
  59.  
  60. Component Three is the LEARN lesson viewer program. LEARN accepts as input 
  61. the CAI file created by LSCAN and executes the commands it contains for 
  62. displaying screens and performing the logic associated with student 
  63. responses.
  64.  
  65. If an extension-less filename is supplied to any of these three programs 
  66. then certain extensions are assumed. Input filenames supplied to EDANSI 
  67. are given the ".SCR" extension; LSCAN uses ".DAT" for input and ".LKI" for 
  68. output files; while LEARN uses ".LKI" as its default input file extension.
  69.  
  70.  
  71. LESSON command descriptions:
  72.  
  73. A group of related commands are organized in units called "cells". A 
  74. single cell contains commands that control the display of text defined in 
  75. the cell and control the selection of the next cell to be processed based 
  76. on the student's response to the text just displayed. The LSCAN program 
  77. converts the ASCII text cell commands into a format called the "lesson 
  78. file". There is a fixed limit of commands and cells which can be converted 
  79. by LSCAN to the Lesson file format; up to 255 cells (with each cell 
  80. containing up to 127 commands maximum) are acceptable for conversion. The 
  81. lesson file is used by the LEARN program to present a lesson to a student. 
  82. After LSCAN creates a lesson file, only the lesson file and the LEARN 
  83. program are needed to allow a student to work with a lesson.
  84.  
  85. LESSON command descriptions (continued)
  86.  
  87. Each LSCAN/LEARN command has the same basic format which consists of...
  88.  
  89.          - a label field,
  90.          - a command field, and
  91.          - an operand field containing one or more operands
  92.  
  93. These fields must be separated by at least one blank or tab character and 
  94. must be placed in the order shown. If the label field is used then the 
  95. statement begins on the first character position of the line, otherwise a 
  96. blank or tab character must be the first character. The entire statement 
  97. is ended by the use of a carridge return character (usually inserted 
  98. automatically by most word processing and editor programs, including the 
  99. DOS EDLIN program).
  100.  
  101. A label field consists of a single or group of alphanumeric (alphabetic or 
  102. number) characters up to 16 characters in length which indicates either 
  103. the student's keyboard response which can cause the command in this 
  104. statement to be executed (a response-label) or indicates the name that a 
  105. group of commands is called by (a cell-label). The author defines the 
  106. label using any combination of alphanumeric characters they desire. 
  107.  
  108. The command field defines what function a statement is to perform. The 
  109. possible functions which can be performed in version 0.6 of the Learn 
  110. System are:
  111.          -   Define a related set of commands (CELL),
  112.          -   Display text to student (DISPLAY, SCREEN),
  113.          -   Determine next group of commands to process based on
  114.                student's entered response (CORRECT, INCORRECT),
  115.          -   Execute DOS level command based on student's entered
  116.                response (SHELL),
  117.          -   Temporarally execute another LEARN lesson based on student's
  118.                entered response (LEARN),
  119.          -   Define the default group of commands to process next (NEXT)
  120.  
  121. The operand field consists of one or more operands separated from each 
  122. other by commas. An operand can be the name of the group of commands to be 
  123. processed next (the cell label), or a text string which provides 
  124. inforamtion required by a command to perform its function (for example, a 
  125. DOS file name for the LEARN command or text to be put on the screen by the 
  126. DISPLAY command).
  127.  
  128. Special Label Names:
  129.  
  130. There are several label names available which can cause special actions to 
  131. be performed like:
  132.  
  133.          1) Endding the current lesson (/EXIT)
  134.          2) Restarting the current lesson (/START)
  135.          3) Causing the cell which was active prior to the current one to
  136.               be activated next (/PREVIOUS).
  137.  
  138. These special label names all start with the slash ("/") symbol and may 
  139. only appear in the operand field wherever a cell-label may be placed.
  140.  
  141.  
  142. Special Cells:
  143.  
  144. Currently only one special cell exists, the /START cell. The /START cell 
  145. is the first cell processed by the LSCAN program as well as the first to 
  146. be activated when the LEARN program begins. This cell is different from 
  147. other cells in the same file in that:
  148.  
  149.          -   this cell can be refered to by two different cell-label 
  150.                names, the name given in the first cell statement in the
  151.                lesson source file or by using the cell-label "/START",
  152.  
  153.          -   any statement which define a response-label in the /START
  154.                cell will also be active as a default response for all
  155.                cells in the same lesson file
  156.  
  157.  
  158. Statement Description:
  159.  
  160.   A cell is defined in the LSCAN input file by the use of the CELL 
  161. command. A cell is terminated by the appearence of another CELL command or 
  162. the end-of-file condition. The format for a CELL command is...
  163.  
  164. label-name (space/tab) CELL (space/tab) option(1),option(2)...,option(n)
  165.  
  166. A label-name followed by a blank or tab character, followed by the word 
  167. "CELL", followed by a blank, tab, or return character. The CELL command 
  168. must have a label and the command word "CELL". Operands may be present but 
  169. are not used in the Learn System version 0.6. It is highly recommended, 
  170. but not required, that the option "ASCII" or "ANSI" be coded as an operand 
  171. in every CELL statement. In future versions of the Learn System this 
  172. operand will be used to indicate the display format the DISPLAY and SCREEN 
  173. commands use in a cell.
  174.  
  175.  
  176. The NEXT command provides the default next cell selection for a single 
  177. cell. If no other commands in the cell cause another cell to be activated, 
  178. then the NEXT command indicates which cell will be activated next. Like 
  179. the CELL command, one NEXT command must exist in each cell. If more than 
  180. one NEXT command exists in a single cell, only the first one is valid, the 
  181. others are ignored. The CELL and NEXT commands are the only commands 
  182. required in each cell, all others valid commands are optional (may appear 
  183. at the discretion of the lesson author). In version 0.6, if the NEXT 
  184. statement is not present in a CELL, the /START cell-label will be used as 
  185. the default NEXT cell. In later versions of the Learn System the situation 
  186. of a cell without a NEXT command might not be allowed.
  187.  
  188. The DISPLAY and SCREEN commands display text on the computer screen. The 
  189. DISPLAY command can display up to one line per command. Its format has one 
  190. text operand and no label. The text string must be enclosed using single 
  191. quote mark, double quote mark, or the vertical bar symbol. If the first 
  192. character of the string is the left bracket symbol, the characters 
  193. following the bracket will be processed as enhanced display control 
  194. characters instead of just displaying these characters as text. Enhanced 
  195. display control characters are defined and explained in the DOS Technical 
  196. Reference manual available from IBM PC dealers everywhere.
  197.  
  198. The SCREEN command specifies the display of an entire screen of text. This 
  199. screen is stored on a disk file prior to the use of LSCAN program. LSCAN 
  200. will read this file and store the screen contents in the lesson file. A 
  201. screen file can be created by any word processing program capable of 
  202. producing an ASCII text file. The EDANSI program supplied with the Learn 
  203. System was designed just to produce screen text files suitable for LSCAN 
  204. processing. The format for the SCREEN command has one operand which is the 
  205. screen file name surrounded by single or double quote marks and no label 
  206. field.
  207.  
  208. The CORRECT and INCORRECT commands both use the same format for marking 
  209. the currently active cell as correct or incorrect based on the student's 
  210. response to the displayed information. A label and a single operand field 
  211. are required for both commands. The label represents the text the user 
  212. must enter to execute this command, while the operand is the name of the 
  213. cell to be activated next when a user response match is made. The label 
  214. contains the minimum alphanumeric characters which must be exactly typed 
  215. by the student to cause a match. The student may type additional 
  216. characters after those which match the label and the match will still 
  217. occur. For example if the cell contains the following commands:
  218.  
  219. DOSFUNC  CELL
  220. CAT      CORRECT   DIRLIST
  221. COPY     INCORRECT TRYAGAIN1
  222. DEL      INCORRECT TRYAGAIN1
  223. CATALOG  INCORRECT TRYAGAIN2
  224.          NEXT      MOREDOSFUNC
  225.  
  226. if the student types "delete" (with the enter key at the end of the line), 
  227. then the LEARN program would determine that "delete" matches "DEL"; the 
  228. cell would be marked as "incorrect" and a cell with the label "tryagain1" 
  229. would be immediately activated. In the case of two words in which one has 
  230. the entire spelling of the other in its begining spelling (such as 
  231. "catalog" and "cat" in the previous example), the ordering of each label 
  232. is important for the LEARN program to properly match a student's response. 
  233. Using the previous example again, if the student enters "catalog", the 
  234. LEARN program will match this response with the "CAT" label and not the 
  235. "CATALOG" label this response was clearly meant for. The same results 
  236. would occur if the student had entered "cat" or even "catal". In this 
  237. example it is not possible for the command with the label "CATALOG" to be 
  238. executed. If the cell contains:
  239.  
  240. DOSFUNC  CELL
  241. COPY     INCORRECT TRYAGAIN1
  242. DEL      INCORRECT TRYAGAIN1
  243. CATALOG  INCORRECT TRYAGAIN2
  244. CAT      CORRECT   DIRLIST
  245.          NEXT      MOREDOSFUNC
  246.  
  247. then the student response of "catalog" would correctly cause the cell 
  248. TRYAGAIN2 to be activated while the response "cat" or "catal" would cause 
  249. the DIRLIST cell to executed.
  250.  
  251.  
  252. The SHELL command is used to temporary execute a DOS command, DOS batch 
  253. file, or disk resident program (COM or EXE file) while the LEARN program 
  254. is loaded in memory. In general, any command executable from DOS command 
  255. level (i.e. "A>") is executable as a subcommand to the LEARN program using 
  256. the SHELL command. The SHELL command uses the label field and has one 
  257. operand which is the DOS command, batch command file, or program name with 
  258. their respective parameters and operands all surrounded by either single 
  259. or double quotes. Any student response which matches a SHELL command label 
  260. field will cause the execution of the text in the operand field as if the 
  261. text had been entered on a DOS command line. After the SHELL command has 
  262. completed its DOS subcommand execution, the NEXT command is immediately 
  263. used to activate the next cell.
  264.  
  265. The LEARN command is used to temporary suspend the current lesson file and 
  266. activate another. This action could be done using the SHELL command, but 
  267. there is a great possibility that later versions of the LEARN program will 
  268. not function properly when executed by the SHELL command. The Learn 
  269. command provides a more reliable and safe method of "nesting" lesson files 
  270. ("nesting" refers to a lesson file temporarily activating another lesson 
  271. file). Nesting can occur up to 10 levels in succession. By using the LEARN 
  272. command the lesson file limitation of 255 cells is overcome by allowing 
  273. the LEARN program to access virtually an unlimited number of cells. The 
  274. format of the Learn command has a label which must match the student's 
  275. response and a single operand which is the lesson name (no quotes 
  276. required).
  277.  
  278.  
  279. The EDANSI Program:
  280.  
  281. The Edit ANSI.SYS screen (EDANSI) program was designed to create or modify 
  282. files which represent screen images for display by the Learn System SCREEN 
  283. command. This program can produce screen text in the two types of display 
  284. formats which are supported by PC-DOS/MS-DOS versions 2.0 and above. Those 
  285. formats are ...
  286.  
  287.     Standard ASCII:
  288.               This format includes all printable ASCII characters plus a
  289.               few (but not all) of the ASCII screen format control
  290.               functions. Using this mode allows the creation of screens
  291.               suitable for all display devices including printers, and
  292.               most ASCII terminals connected to a PC by modems or RS-232
  293.               connectors. This format does not support the use of color or
  294.               the use of some PC characters (which overlap the ASCII
  295.               control code characters).
  296.  
  297.     Extended Screen and Keyboard Control:
  298.               This format is fully explained in the DOS Technical
  299.               Reference manual. In summary, this format supports the use
  300.               of color, direct cursor positioning, and keyboard key code
  301.               reassignment (redefining of keyboard keys to produce codes
  302.               other than those codes it normally produces). This format is
  303.               a subset of the ANSI format used in popular ANSI terminals
  304.               such as the DEC VT-100 and VT-220 family.
  305.  
  306. Please note that both of these formats are quite different from the BASIC 
  307. language display format (which supports all ASCII screen control 
  308. characters, unlike DOS which supports only a few ASCII screen control 
  309. characters).
  310.  
  311. The EDANSI program offers a simple method of creating display screens 
  312. without requiring a lesson author to understand either display format. By 
  313. using various option screens, the author can define foreground and 
  314. background colors, screen size, and screen attributes. Some special IBM-PC 
  315. display characters are made available for inclusion into screens, like the 
  316. currency characters, line graphics characters, and assorted 
  317. engineering/math/foreign language characters.
  318.  
  319. Once a screen has been created using EDANSI, its file name can be used in 
  320. the LSCAN/LEARN SCREEN command to process the screen as a part of a lesson 
  321. file.
  322.  
  323. Getting Started:
  324.  
  325. 1)  Use the EDANSI program to create or edit screen files which will
  326.     present the information and desired responses to be a student. To
  327.     start EDANSI simply enter its name to the DOS prompt, no operands are
  328.     used. For example:
  329.                          A>cls
  330.                          A>edansi
  331.  
  332.     will clear the screen and start EDANSI. The first thing EDANSI will
  333.     request is a file name for an existing file to be edited or a new file
  334.     to be created. If no file name extension (or qualifier) is specified
  335.     then the extension ".SCR" is added to the file name supplied.
  336.  
  337.     When the initial setup is complete, EDANSI is placed in text screen
  338.     edit mode. You can use the cursor keys move around the screen, and
  339.     enter text at any position except on the last character of each line
  340.     or on the last line of the screen, these are used by EDANSI for line
  341.     position control characters (yielding a 39x24 or 79x24 usable screen
  342.     depending on the screen width selected). This mode has several
  343.     function key submodes which are selectable at this point. The SAVE and
  344.     END submode can cause the end of EDANSI execution with or without
  345.     saving the currently editted screen. The OPT submode allows the
  346.     selection of various screen display options and special character
  347.     select.
  348.  
  349.     The DRAW submode allows a user to draw horizonal or vertical character
  350.     graphics symbols into desired patterns and shapes. Two submodes within
  351.     the DRAW submode can act as toggle switches to indicate:
  352.  
  353.               a)    DRAW line by following the path of the screen cursor,
  354.  
  355.               b)    MOVE cursor without drawing or erasing any line
  356.                       currently on the screen,
  357.  
  358.               c)    ERASE line by following the path of the screen cursor,
  359.  
  360.               d)    Draw SINGLE line when following the cursor,
  361.  
  362.               e)    Draw DOUBLE line when following the cursor.
  363.  
  364.     Of special note is that under EDANSI, the (esc) key is used to place
  365.     selected special IBM-PC characters on the screen in the text screen
  366.     editing mode. Characters are selected or unselected (but not erased)
  367.     using the OPT submode called "Assign Chars to (esc) key". In the text
  368.     screen editing mode the (esc) key acts as a toggle switch which
  369.     displays one of the selected special characters per each press of the
  370.     (esc) key.
  371.  
  372.     Please also note that EDANSI does not support all Extended Screen and
  373.     Keyboard Control features, just those that are most useful to most
  374.     users. Other features can be specified using the LSCAN/LEARN DISPLAY
  375.     command.
  376.  
  377.  
  378. Getting Started (continued):
  379.  
  380.     2) Using the Lesson conversion program (LSCAN) involves four main 
  381.     steps:
  382.  
  383.               a)    Create an ASCII text file containing Learn System
  384.                     LSCAN/LEARN commands. The PC-DOS/MS-DOS EDLIN program
  385.                     produces files that are just perfect for LSCAN,
  386.                     however you can use word processors or line editors
  387.                     such as WordStar, Multimate, Volkswriter provided that
  388.                     the word processing files are converted to normal
  389.                     ASCII format files in the same format as EDLIN
  390.                     processed files
  391.  
  392.               b)    Execute the LSCAN with or without the source lesson
  393.                     file name as an operand. For example:
  394.  
  395.                          A> lscan
  396.                          A> lscan lesson1
  397.                          A> lscan lesson1.dat
  398.  
  399.                     are all valid for converting a source lesson file
  400.                     called "LESSON1.DAT" to ".LKI" presentation format.
  401.                     The first will cause LSCAN to prompt the user for a
  402.                     file name since none was supplied. The second assumes
  403.                     that the file name has the file name extension ".DAT"
  404.                     (thus making the file name to be access "LESSON1.DAT")
  405.                     since none was supplied; a file name that has no
  406.                     extension can only be specified by having a single
  407.                     period at its end (i.e. "LESSON1."). The third example
  408.                     has the entire file name stated which does not allow
  409.                     LSCAN to assume anything (the disk drive and path
  410.                     portions is also supported by all Learn System
  411.                     commands and could have been made a part of second and
  412.                     third examples above).
  413.  
  414.                c)   If any source lesson statements are in error, a
  415.                     message is print along with the line number indicating
  416.                     the statement's location in the file. These line
  417.                     numbers corresponse to EDLIN line numbers. Please note
  418.                     that under LSCAN version 0.6 many errors involving
  419.                     cell-labels which refer to non-existent cell names and
  420.                     response-labels which refer to non-existent response
  421.                     statements are not caught as LSCAN errors.
  422.  
  423.                d)   When the DOS prompt reappears, processing is done and
  424.                     a lesson file usable by the LEARN program is produced.
  425.                     This file is only a valid one if no errors were
  426.                     reported by LSCAN.
  427.  
  428. Getting Started (continued):
  429.  
  430.     3) To use the Learn System Lesson Presentation program only one action
  431.         is needed, execute the LEARN program with a lesson file name. For
  432.         example:
  433.  
  434.                     C> learn
  435.                     C> learn examples
  436.                     C> learn examples.lki
  437.                     C> learn a:\examples
  438.  
  439.          are all valid ways to execute the LEARN program with the lesson
  440.          presentation file "EXAMPLES.LKI". The first will cause the LEARN
  441.          program to prompt the user for a lesson file name. The second
  442.          will cause the LEARN to assume that file name extension ".LKI" is
  443.          to be added to the supplied file name (resulting in the LEARN
  444.          program access file "EXAMPLES.LKI"). The third causes the LEARN
  445.          program to assume nothing since the file name and extension are
  446.          both supplied. The fourth example is equivalent to second example
  447.          since no file name extension was supplied. For all Learn System
  448.          programs, the disk drive and path portions of a file name may be
  449.          specified if desired, the rules affecting file names with and
  450.          without file name extensions remain the same. The same rules also
  451.          apply to the file name entered as a result of a prompt given by
  452.          the LEARN program as in the first example.
  453.  
  454.  
  455. Lesson Creation Example:
  456.  
  457. To be successful with this example you must first use the EDANSI program
  458. to create three screen:
  459.  
  460.     "TITLE.SCR"     This will be your first screen displayed when the
  461.                     LEARN program starts. Please place your name and
  462.                     business address as a part of the screen. This screen
  463.                     will introduce the student to what's coming later. The
  464.                     following menu should be displayed on the screen:
  465.  
  466.                          1 - This screen
  467.                          2 - Color screen test
  468.                          3 - My Artwork
  469.                          9 - Exit back to DOS
  470.                       Please select a number above
  471.  
  472.     "COLORTST.SCR"  This will be a screen which will display your favorite
  473.                     color as the forground color and a nice contrasting as
  474.                     the background color if you have a color monitor. If
  475.                     your monitor is monochomatic (single color) then use
  476.                     black as the foreground color and white as the
  477.                     background color. Display a message like the one
  478.                     below:
  479.  
  480.                          Color Test Screen
  481.                          Blue foreground color with White background
  482.  
  483.                          Enter one of the following numbers:
  484.                              1 - Go to next cell
  485.                              2 - Display this screen
  486.                              3 - Display my Artwork(TM)
  487.                              9 - Exit back to DOS
  488.  
  489.      "ARTWORK.SCR"  This screen allows you to show off your creativity
  490.                     with drawing boxes, my only request of you is that you
  491.                     include the words "My Artwork" at the very top of the
  492.                     screen and you use the default colors for this frame
  493.                     (which are black background and white foreground).
  494.  
  495. Next you'll need to use either EDLIN or your favorite word processor
  496. program to create a lesson source file for the following Learn System
  497. statements. Save this file as file name "Example3.dat".
  498.  
  499. Example three contents:
  500.  
  501.  column: 1        9          19                
  502.          +--------+----------+---------------------------   
  503.  
  504.          First    cell       Ascii
  505.                   screen     "Title.scr"
  506.          2        correct    colortst
  507.          3        correct    MYartwork
  508.          9        incorrect  /exit
  509.          1        correct    first
  510.                   next       nocell
  511.          Nocell   cell       Ansi
  512.                   display    "[0m"
  513.                   display    "[10;5H"
  514.                   display    "    Invalid Entry Choice"
  515.                   next       /previous
  516.          colortst cell       ansi
  517.                   screen     "colortst.scr"
  518.          1        correct    myartwork
  519.                   next       nocell
  520.          myartwork cell      ansi
  521.                   screen     "artwork.scr"
  522.          9        incorrect  /start
  523.          2        incorrect  /start
  524.          3        incorrect  /start
  525.          1        incorrect  /start
  526.                   next       /start
  527.  
  528. Next, review the steps needed to install ANSI.SYS to your version of DOS, 
  529. and create any files necessary to support the ANSI.SYS enhanced screen and 
  530. keyboard control support. All the information you need is in the DOS 
  531. Manual.
  532.  
  533. Last (but not least), you must process your ".dat" file with LSCAN to 
  534. create a ".LKI" file. This lesson presentation file when run with the 
  535. LEARN is your first lesson. Try it out and think about your next lesson.
  536.  
  537. Final Note:
  538.  
  539. The Learn System was designed with growth in mind, so please tell me about 
  540. your experiences with this program, good or bad, so that I can know what 
  541. things to change and which to just leave the same. Feel free to make 
  542. suggestions by mail for future changes or enhancement you'd like to see in 
  543. new versions of the Learn System. If you develop an exceptional lesson you 
  544. want to share (for profit or not) with the world let me know, I'll send 
  545. you information on selling your lesson with a special commercial license 
  546. version of the LEARN program. 
  547. Lesson Design Using the Learn System:
  548.  
  549. 1) The Lesson Author creates a lesson plan which includes a written copy 
  550. of the information to be presented in a paragraph form.
  551.  
  552. 2) The Lesson Plan is segmented into computer display screen sized 
  553. sections and is entered onto a computer disk using a word processor, line 
  554. editor, or EDANSI program. 
  555.  
  556. 3) Test questions are formulated and added as screens where apropriate.
  557.  
  558. 4) The Lesson flow and logic is flowcharted and entered into a LSCAN ASCII 
  559. lesson file using a word processor or DOS line editor (EDLIN).
  560.  
  561. 5)  The LSCAN input file and screen images are processed by LSCAN to 
  562. produce a .LKI lesson file.
  563.  
  564. 6) The Author practices being a student using his lesson file and the 
  565. LEARN program. If lesson usage problems occur then the LSCAN input file 
  566. and/or screen images files are edited to correct those problems.
  567.  
  568.  
  569. DISCLAIMER:
  570.  
  571. Programs and related materials created by Keeley Information are provided 
  572. "as is" without warranty of any kind, either expressed or implied, 
  573. including, but limited to the implied warranties of merchantability and 
  574. fitness for a particular purpose. The entire risk as to the quality and 
  575. performance of this program is with you. You assume the responsibility for 
  576. the selection of the programs to achieve the results you desire and for 
  577. the installation, use, and results from these programs.
  578.  
  579. In no event will Keeley Information be liable to you for any damages, 
  580. including any lost profits, lost savings or other incidental or 
  581. consequential damages arising out of the use of or inability to use these 
  582. programs, even if Keeley Information has been advised of the possibility 
  583. of such damages, or for any claim by any other party.
  584.  
  585.  
  586. RESTRICTED PERMISSION TO COPY:
  587.  
  588. The Learn System is NOT a public domain program. Individuals are granted 
  589. permission to freely copy the Learn System diskette for their own use or 
  590. for others to evaluate, so long as no price or other consideration is 
  591. charged. 
  592.  
  593. Non-profit computer clubs, schools and universities are granted permission 
  594. by the author to copy the Learn System diskette and share it with their 
  595. members provided:
  596.  
  597.   - the organization has officially paid for its master copy of the Learn
  598.     System,
  599.  
  600.   - the program and documentation are not modified in any way,
  601.  
  602.   - those who receive the program are encouraged (in writing) to support
  603.     the further development of the Learn System by sending a $40
  604.     registration fee the author.
  605.  
  606.   - the programs may not be distributed via computerized "bulletin boards"
  607.     or through any other telecommunications link.
  608.  
  609. Others may be granted permission by the author to distribute the Learn 
  610. System (including software developers wishing to include Learn System 
  611. programs with software which they may be selling or distributing) so long 
  612. as:
  613.  
  614.   - permission is obtained in writing from Keeley Information specifically
  615.     authorizing the distribution of the Learn System. This permission must
  616.     be obtained before distribution is commensed.
  617.  
  618.  
  619.  
  620. ADDITIONAL INFORMATION:
  621.  
  622. The sample '*.lki' files supplied are designed to be used with ANSI.SYS 
  623. device driver supplied with PCDOS 2.10 and above. Proper installation of 
  624. ANSI.SYS involve the following steps:
  625.  
  626.   - create or add to an existing CONFIG.SYS the command "DEVICE=ANSI.SYS",
  627.  
  628.   - insure that both a copy of the ANSI.SYS file (copied from the PCDOS
  629.     system diskette) and a copy of CONFIG.SYS file (mentioned above) is in
  630.     the directory of the disk which will be used to initially boot up
  631.     PCDOS.
  632.  
  633.   - the computer is booted using the disk or diskette mentioned above.
  634.  
  635.  
  636. DISPLAY COMMAND CONTROL SEQUENCES SUMMARY:
  637.  
  638. The Learn System DISPLAY command can be used to control screen display by 
  639. using ANSI.SYS screen control sequences provided the first character used 
  640. in the DISPLAY command's text field is "[". The "escape" character which 
  641. must prefix all ANSI.SYS control sequences will be automatically generated 
  642. by the LSCAN program when the lesson file is being converted to "*.LKI" 
  643. format. The following summary describes some ANSI.SYS functions which may 
  644. be used with the DISPLAY command.
  645.  
  646.  
  647.     ..Text..  .............Description............................
  648.     [#;#H     Used to move the cursor. '#' is a single or double digit
  649.               number, the first '#' specifies screen row, the second
  650.               specifies column.
  651.  
  652.     [s        Save current cursor position.
  653.  
  654.     [u        Restore cursor position to that which had been saved using
  655.               function "[s".
  656.  
  657.     [2J       Erase entire display, and set cursor at home position.
  658.  
  659.  
  660. All other ANSI.SYS functions are also usable, please refer to the DOS 
  661. Technical Reference for a complete list of functions.
  662.  
  663.