                         A Brief Explanation

The document that you are about to read is a Black Magic created Hypertext
document.  The purpose of this short prelude is to introduce you to the
concepts of hypertext if you don't know them, and to teach you how to read
hypertext if you don't know.  If you do know this information, please go to
the end of this document and activate the Link there.

Hypertext is based on the concept of "Expanding Information".  With hypertext,
blocks of information (text or graphics) can be linked to other blocks of
information.  Once two blocks of information have been linked together, they
provide an instant "gateway" to the other.   This is the expanding information
nature of hypertext.  A single block of information can lead to another and so
on.  Information can literally expand at the user's request.  

     Black Magic
               
Black Magic is a product to create Hypertext documents similar to the above
description.  With Black Magic documents, information can be linked in three
different ways; with Note Links, Reference Links, and Replacement Links.  A
Note Link calls up a small window on screen that contains a "note" to the
user.  A Reference link is used to transport the reader to Another place in
the document.  Replacement Links are used to swap one block of information for
another.   Graphic Links are used to make a graphic image a Link Originator. 
Although Graphics can be any of the three types of Link, only the one symbol
below is used to indicate this.  All Links are indicated through the use of
colored symbols embedded in the text.  The symbols surround the Link
Originator (See Below).  Hypertext Links are indicated through the following
symbols:

          Note Link                Yellow Diamonds
          Reference Link           Green Triangle
          Replacement Link         Pink Square
          Graphic Link             Blue Circle with a "X" in the Center 
     

     Terminology 

Link Originator - The starting point to the link.  It is surrounded by the
               symbols to indicate that it is a hypertext link.
Link End - The other side to a Link originator, where reader is taken after a
               link is traversed. 
Traverse - The act of traveling from a Link originator to its associated Link
               End.

     Reading A Document  
          
A Black Magic document is read through the use of the reader programs.  Three
of these reader programs exist:READEGA.COM (For the Enhanced Graphics
Adaptor), READHGA.COM (For the Hercules Graphics Adaptor), AND READCGA.COM
(For the Color Graphics Adaptor).  To use one of the Reader program to read a
Black document, type the following from the DOS prompt:

     READXYZ filename.mag

Once the document is in the Reader program, it is read using the following
keys:

          Traverse Link            <F1>/Left Mouse Button pressed between the
                                             symbols
          Return from Link          <Esc>/Right Mouse Button  pressed anywhere
                                             in the Link
          Movement                  <ArrowKeys>, <PgUp> & <PgDn>/Mouse

When you are reading a document, and you come across a hypertext Link in the
text, move the cursor between the symbols and press <F1>.  This will activate
the Link, traversing you to the Link End.  To return from the Link End pres
<Esc>.  This will bring you one link back from your current position.    

When you come across a hypertext link in a Graphic, move the cursor over the
Graphic Link (Circle with an "X") and press <F1> to traverse the Link.

And that's about all you need to know to read a hypertext document.  Press
<F1> between the Symbols below to continue with the document.

               Press <F1> Here (Anywhere between the symbols)

