PlusShell v1.0 Alpha for the TI-89 and TI-92 Plus
Written by Rusty Wagner
For updates check http://home1.gte.net/river
Send questions, comments, or bugs to river@gte.net

NOTE: This version of PlusShell uses a new binary format shared with
      Doors OS.  Old programs must be converted with the included 'convert'
      program.  Details are described below.

The complete documentation for PlusShell is stored in HTML format within the
DOCS subdirectory.  Open index.htm to start.

FEATURES
* Runs on both the TI-92 Plus and the TI-89.
* Binary compatible with Doors OS v0.85 or higher.
* Uses a kernel to reduce the size of programs.
* PlusShell will automatically detect the calculator it is running on and
  adapt itself.  If designed using the new format (described in CONVERT.TXT),
  one binary will run on both the 89 and the 92+, thus allowing the transfer
  of assembly programs between the two calculators.
* Library support.  Includes gray4lib, gray7lib, hufflib, hexlib, linelib,
  as well as a utility library equivilent of Fargo's flib
* Fargo II source and binary compatibility.  Many Fargo II programs can be
  run by simply using the automated conversion program.  See CONVERT.TXT for
  information on any differences in the source code format.  See COMPAT.TXT
  for notes on Fargo II binary compatibility.
* Browser which handles folders and displays program comments.

Before you can run PlusShell programs, you must install the kernel.  First,
transfer kernel.9xz or kernel.89z to your calculator.  Then type kernel()
at the home screen and press Enter.

Programs and libraries compiled for previous versions must be converted to
the new format.  Run CONVERT.BAT on the program to convert it.  For example,
to convert a program named mario92, type this at MS-DOS prompt in the
directory where mario92 resides:
        convert mario92
Please note that some older programs will not run on the TI-89.

Please note that the "ASM92P" environment variable has been changed to
"PLUSSHEL", as PlusShell is no longer limited to the TI-92.  Please change
your AUTOEXEC.BAT file if you used an earlier verion of PlusShell.

PlusShell runs on the TI-89 and TI-92 Plus.  To run programs on the TI-92 or
TI-92II, Fargo II must be installed.  Fargo II can be found at www.ticalc.org.

PlusShell has a converter which allows the execution of Fargo II and old
PlusShell binaries.  Please note that Fargo II programs will be missing the
lower and right parts of the screen when run on the TI-89.  Run CONVERT.BAT
on the Fargo program or library to convert it to a .9xz file.  It will then
operate just like a normal PlusShell program or library.

PlusShell has full support for BSS sections.  These sections are
automatically allocated and the program is automatically relocated.

Version 1.0 allows archived programs to be executed.  The program is
first copied to main memory.  Please note that high score lists will not
work properly when a program is archived.  Libraries can not be archived.

The source to everything is included for anyone who wants to port them to
another OS (MacOS, for example).  You can do anything with it except claim
that you wrote it.


You can find PlusShell as well as other programs on my web page at:
http://home1.gte.net/river

If you have questions, comments, or have found a bug, contact me by e-mail
at river@gte.net

Fargo was created by David Ellsworth and can be found on ticalc.org at:
http://www.ticalc.org
