CAI
				---
Submitted by:	Chris Doran				Date: April 1988
		Sira Ltd., South Hill, Chislehurst, Kent, BR7 5EH, England.
		Tel: +44 1 467 2636,	Telex: 896649,	  FAX: +44 1 467 6515

A menu-driven Computer Aided Instruction facility. The original was part of Jim
Downward's VPW (KMSKIT) package. However, this submission has been unbundled
from VPW, and extensively revised and corrected for VMS V4.4 ff. (V4.4 is
required because it uses CALL and GOSUB.)

To install, COPY into SYS$INSTRUCTION all the files from this directory
(including BOTH versions of DIFDEMO.FOR), except AAAREADME.TXT, CAI.HLP, which
goes into your HELP library, and DISPLAY.FOR which you only need to modify
DISPLAY.EXE (see below). Then define a foreign command:

	$ CAI :== @SYS$INSTRUCTION:CAI

The menu contains options to select Digital's VMS2CAI and EDT2CAI self-paced
courses. Delete these menu options in CAI.COM if you don't have them. There is
also some commented-out code for the KMSKIT Datatrieve CAI package, which I
haven't installed because we don't have Datatrieve. Also commented out is
code to call the TYPIST program from the Decus tapes, as I haven't got that
installed yet.

Unlike Digital's products, CAI.COM will work on a variety of terminals --
VT100, VT200, VT300, VT52, and HP2648a (as FT1) are supported. This is done
partly through terminal-specific definitions at the beginning of CAI.COM, and
mainly through a program called DISPLAY, which reads text containing a VT200
escape sequence subset, and reformats it for one of the above. Read DISPLAY.FOR
for details. There are some fiendishly horrible bodges in some of the command
procedures to get around (or use) "sticky" display attributes on HP terminals.

I have dummied out questions about to networks in some files, since we don't
have a network. Delete the !'s in Final_Exam sections to put them back.

The structure of the courses makes it fairly easy to create others. Start with
one of the command.COM's as an example. If you do produce any more courses, I'd
like copies! The best way to approach writing a course seems to be to type in
your description as if you were writing a manual, but targeted to 24-line
snippets. Then edit in the "Press return to continue"'s, and any animated
diagrams you can think up. Keep an eye open for basic introductory articles in
DEC User, and other magazines, to build courses around. CAUTION: It takes much
longer to get diagrams to work than you think -- you begin to understand how
Walt Disney used to produce only one or two frames of cartoons a day, and why
DEC's CAI courses are so expensive!

Of the courses supplied, the Machine Introduction is (a) very site-specific,
(b) incomplete, (c) too detailed to be really an "introduction", and (d) isn't
described in CAI.HLP (yet). You will need to modify it for your site.

CHANGES THIS SUBMISSION (Apr 88)
--------------------------------
DISPLAY.FOR (&.EXE) modified to correct handling of csi = esc[, add esc [ n X
support, improve double-height/double-width line handling, and accept a
single line from the command line if defined as a foreign command.