                             *********
 ** SHAREWARE 1994! **       * LEARN *       (a KEYDEF support program)
                             *********
                            Version 2.1
                           
                         By Ondrej Blazek!


Have a nice exit description for modem chat conferences? Want to be able to
toss text files into chat conferences? Ever needed to pass text files over
modems or Email that did not have direct support for it? If so then LEARN
is for you!

ATTENTION: LEARN 2.1 is a support program for KEYDEF. LEARN 2.1 will be
           useless without KEYDEF and its files. KEYDEF can be found on
           the same BBS as LEARN or can be obtained from the author.


1.0 PURPOSE:
------------

LEARN allows you to define KEYDEF macros through text files instead of the
normal "key by key" process. This enables users to quickly create macros
which will print names, lists, documentation files or any other text files.
LEARN even supports multiple text files in a single KEYDEF defenition thus
enabling the user access to a multidute of text files at the press of a
key combination.


2.0 HOW TO USE:
---------------

The syntax of LEARN 2.1 is as follows:

        LEARN textfile textfile2 textfile3 ...

The first "textfile" name is mandatory and denotes the drive, path and
filename of the text file that is to be attached to a macro key. Any
following filenames are optional and indicate other text files (drive,
path and name) which are to be attached to macro keys.

Once the command is executed, LEARN will inform the user to which keys the
text files have been attached to. The first text file will always be invoked
by ALT Q but any following text files will change their initiation key 
depending on the length of the first text file.

Finally start KEYDEF as usual (see KEYDEF.DOC for more information). This is 
done by typing KEY, if the LEARN program was executed in the same directory
as KEY (or by setting the DOS enviromental variable KEYDEF to the correct
directory if the directories differ and then typing KEY. See KEYDEF.DOC for
more information on macro defenition directories).


3.0 CHANGING MACROS IN MID USE 
------------------------------

To change text macros after a set has already been installed, there are the
steps to follow:

        1) Create the new macro files, using LEARN, as ususal.

        2) Instead of using the KEY program with no parameteres,
           use the folowing format:

                KEY INSTALL KEYDEF.DEF

           (See KEYDEF.DOC for more information on the INSTALL parameter)


4.0 SIZE OF FILE:
-----------------

Although KEYDEF's macros are limited to 255 characters, the text files used
by LEARN are not! LEARN will automatically detect files greater than 255
characters and place the next 254 characters on the next keyboard sequencial
key (ie. after ALT Q is ALT W then ALT E and so on). This does NOT mean that
the user must press ALT W to activate the rest of the sequence because the
255th key in each defenition tells KEYDEF to activate the next macro key.

Ideally this means that the file size is unlimited but defenitions with a
size greater than 26x255 (6630) characters (or about 82 full lines) could 
start causing problems because they are redefining keys beyond the normal
ALT and letter combination.


5.0 KEYDEF COMPATABILITY:
-------------------------

LEARN 1.0 was designed specifically for KEYDEF but is only used to create
a standard KEYDEF macro defenition file. This means that all examples,
hints, tips and restrictions outlined in the KEYDEF.DOC file still apply
when using the ALT A macro key. Although LEARN 1.0 does not support multi
text file macro keys the procedure outlined in KEYDEF.DOC for creating
multiple macro defenitions can be used to create one defenition for each
text file.


5.0 THE VERSIONS:
-----------------

        1.0     Basic LEARN program, supported single text file macro key.
        1.1     Fixed bugs in 1.0 Version.
        2.0     Added multi text file capabilities
        2.1     Added Key Identification

   (Thanks to Terry C. Stewart for the individual key scan codes)









                     ----------------------
                     -   SHAREWARE 1994!  -
                     ----------------------

This program is 100% SHAREWARE and can be copied and distributed
under the following rules:


1)   None of the files may be altered in any way especially, but
     not limited to, any of the credits (in this file or the main
     program), notes or the program name.

2)   The main program must always be accompanied by this DOC file.

3)   And there is to be no fee charged for any copying or
     distribution of this program excluding shipping and handling
     charges.

Under the SHAREWARE agreement you may preview this program for 30
days with no obligation. If you find LEARN useful and continue to
use it after the 30 day trial period please send a registration fee
of $5 to $10 dollars to the address below. Please note that this
registration fee is INDEPENDANT of the OBBUF registration fee.
To use LEARN, both programs must be registered. Registration for both
programs can be made in one playment.

With registration user obtain: All updates of LEARN
                               Info about LEARN related programs
                                   
And as always your financial support ensures the continuation of
future program development!

Send your Registration Fee, Comments or Bugs to the

                               Programmer:   Ondrej Blazek

                                             847 Ludgate Cr.
                                             Kingston, Ontario
                                             K7M 6C7 CANADA
