Name: Boreal
Version: Beta 4
Author: Jareth Software
Machine: Ti-83
Description: 
	Boreal is a GUI for the 83.  It currently only runs programs 	but will rival the 83-OS for controling the calc.

Contents:
*1* Installing Boreal
*2* Using The Mouse
*3* Boreal Formatted File Names
*4* Installing Programs For Boreal
*5* Setting A Background
*6* New Features And Changes From Beta 3
*7* How To Reach Me

-----------------------------------------------------------------------

*1* Installing Boreal:

1) Copy BREAL_B4.83G to Ti-83.
2) Run prgmBOREAL (This does an initial setup.)
3) Using the arrow keys, mauever the arrow over "Start" and press    ENTER.
4) Move the arrow over "Exit" and press "ENTER".
5) Move the arrow over "TI-OS" and press "ENTER".

Boreal is now ready to run any program that you install.

-----------------------------------------------------------------------

*2* Using The Mouse:

	By now you have already covered the basics of the mouse.  The arrows move the arrow cursor and ENTER clicks.

-----------------------------------------------------------------------

*3* Boreal Formatted File Names:

	In an attempt to clear up most of the garbled program and sub program names, Boreal uses a standard up to 5 character name and 3 character description.  Th descriptions are as follows.

	RUN - Executable file.  (Used in prgmBORLPRGS)
	ICO - Icon file.  (Used in prgmBORLICNS)
	DAT - Data files.  NEVER run these files, they could cause 	      strange or serious damage to your calc.
	DT0 - Data file for a program that needs more than one. 	      (DT0-DT9)
	TXT - Text files.  (Not Implemented yet)
	
More file descriptors are to come once Boreal Beta 5 is released.

-----------------------------------------------------------------------

*4* Installing Programs For Boreal:

Editing prgmBORLICNS:
      
      Boreal calls on prgmBORLICNS to display icons.  It does this by passing a numeric value to "C".  From here on out this will be known as the "C Value".  Each Boreal program must have a C value in order to be called, and you must use your programming skills to tell it where the programs are (with beta 5 this will be fixed).  To do this you need to edit prgmBORLICNS.  It should look like this:

PROGRAM:BORLICNS
:If C=1:prgmNAMEICO
:If C=2:prgmHELLOICO

Where NAMEICO & HELLOICO are the icon files of the desired program.


Editing prgmBORLPRGS:

	Much like prgmBORLICNS, Boreal calls on prgmBORLPRGS to run programs.  It also passes a number through the C value and looks very much the same.  prgmBORLPRGS should look like:

PROGRAM:BORLPRGS
:If C=1:prgmNAMERUN
:If C=2:prgmHELLORUN

Where NAMERUN & HELLORUN are the run files of the desired program.

IMPORTANT: Make sure that the C values for a program match up in prgmBORLICNS and prgmBORLPRGS.


The FINAL step:

	Now you must run prgmBOREAL.  None of the new icons will be shown because you haven't told Boreal how many programs to look for.  To do this you need to select "SETUP" from the START menu and set MAX NUM OF APPS to the maximum C value in prgmBORLICNS.

You will also need to read the programs help file for program names.

-----------------------------------------------------------------------

*5* Setting A Background:

	Boreal uses Pic2 as a background, so if you want a background save it as Pic2.  Initially Boreal's Background setting is OFF.  To change this you must select "SETUP" from the START menu and change BACKGROUND to ON.

-----------------------------------------------------------------------

*6* New Features And Changes From Beta 3:

   Mouse:
	Boreal's mouse is now in ASM, providing a faster pointer.  	However, due to my inexperience with ASM you no longer have the 	quick keys.
	
   Contrast:
	You can adjust the contrast as you normally would in the TI-OS.

   Power Down: 
	After 5 minutes of inactivity the calculator will shut down, 	returning right where you left off.

   Off: 
	Through the EXIT menu you can Shut Off the calculator.

-----------------------------------------------------------------------

*7* How To Reach Me:

	If this file didn't really help then please E-mail me at jarethsoftware@geocities.com.
	To find the latest from Jareth Software visit http://www.geocities.com/Heartland/3247/index.html.

-----------------------------------------------------------------------

You may distribute BOREAL as long as this .TXT file is included with it.  If you post it on a web page you must include a link to http://www.geocities/com/Heartland/3247.index.html.

(C) 1997 Jareth Software