                      Files on the Distribution Disk

Filename.x      Description of Contents
-----------     -------------------------------------------------
README.!!!      This file (you're reading it now)
WHATS.NEW       Description of new features and fixes, etc.

TWU1DOC.TXT     Report on Research (58 pages; copy to PRN:)

TWU1.EXE        The Supplied Program ready to run

TWU1.PAS        Turbo Pascal Source - The Main Program
TWU1EQU.PAS	Turbo Pascal Source - General-Purpose Stuff
TWU1RPT.PAS     Turbo Pascal Source - Text File Output Unit
TWU1UAM.PAS     Turbo Pascal Source - Access Methods for .TPU Files
TWU1UNA.PAS     Turbo Pascal Source - Disassembler Unit



                            Resources Required

This program was developed on a Dell System 316 (386-SX) system having 5
Mb RAM, 100 Mb Hard Drive, Super VGA Color.  Also used was a Dell System
316SX with 2 Mb RAM and 80 Mb Hard Drive, VGA Color Plus.

The program is intended to run on almost any system that is supported by
Turbo Pascal Version 6.0 for development.  It's even possible that it may
work on a system having as little as 256Kb of RAM but no guarantees.

Subject to the limitations below, the source codes are supplied without
charge and without warranty.  The source is highly sensitive to Turbo
Pascal Version 6.0 and will NOT compile on earlier versions.


                          License & Restrictions

You are free to use this material at your own risk for your own personal
and NON-COMMERCIAL ends.  You are free to distribute COMPLETE copies of all
materials via any means to any recipient provided that no charge is made
therefor save a small and nominal fee whose sole purpose is to recover
reasonable distribution expenses.  You MAY NOT make use of these materials
in a commercial manner.

No warranties of any kind are made by the author.  Should your use or
distribution of this material result in damages to you, the damages are yours
to bear.  The opinions and findings contained in this material are those of
the author and of no other person.


                               Running TWU1

To run the program, simply type TWU1 at the command-line prompt.  You will
be asked for the name of the unit.  Reply with the name of the .TPU file
but WITHOUT the .TPU extension.  The unit must be in the current directory
or in some directory on the current path, either as "name.TPU" or imbedded
in a TURBO Pascal Library (TPL).  You will then be asked if the unit is for
MS-DOS or for WINDOWS.    You will then be asked whether or not to
disassemble the object code.  If you reply "Y", you will be asked what CPU
to support.

Disassembly can be useful for code tuning.  However, be aware that units
supplied by Borland with TURBO Pascal for WINDOWS are BIG!  Disassembly can
bloat the size of the listing file for one of these units up to about 1.7Mb
(from 1.2Mb).

Vernon Buerg's LIST Utility is highly recommended for viewing the results
without printing, or use the COPY command to print.


                                The Author

This work was done by William L. Peavy, Houston Texas as a private research
endeavor.

I am interested in feedback, suggestions, constructive criticism, and
success stories.  I can be reached via Compuserve (70042,2310), via the
HAL-PC Telecom-1 BBS or via the HAL-PC Telecom-2 BBS.  Especially welcome
is feedback regarding new discoveries that you might make about .TPU files.


Enjoy!
