T Interpreter

T is an easy to learn, user friendly, high
level, computer programming language. If
you already know how to program in another
language, T should be easy to master.
The interpreter includes built-in debugging
tools, an editor, and an on-line language
reference program. It can be operated from
any IBM PC compatible computer.

T Interpreter

T is an easy to learn, user friendly, high
level, computer programming language. If
you already know how to program in another
language, T should be easy to master.
The interpreter includes built-in debugging
tools, an editor, and an on-line language
reference program. It can be operated from
any IBM PC compatible computer.



IMPORTANT NOTICE:

The T interpreter software has been developed and tested on
IBM PC compatible computers. You may use it for free.

While I have made a substantial effort to make the T
interpreter software error free, all computer software by
its complex nature is likely to have some undiscovered
errors. Whether you register this software or not, I
will not be responsible for any direct or indirect damages
which you may incur, including incidental and consequential
damages. This allows me to provide this software for your
use at a very low cost. You must determine whether it is
suitable for your own use.

If you do pay to register this shareware you will receive the
user's manual.

If you are not satisfied with it, I will refund the registration
fee upon return of the user's manual. This must be done within
sixty (60) calendar days of registration.



INSTALLING THE T INTERPRETER

Here it is assumed that your computer's hard disk drive is
the c: drive and that you are copying the T interpreter
files from a distribution diskette.

First, log on to the root directory and create a new
directory for these programs:

C:\>md tpl Then press the key

Second, insert the diskette containing the T Interpreter
into the floppy disk drive and check that you received all
the needed files:

C:\>a: Press

A:\>dir Press

You should see listed:

TI.EXE <- the interpreter
TH.EXE <- the language help program
TE.EXE <- the editor

and several files which have the file name extension ".T"
indicating that they are T programs provided as samples.

Third, copy all these files to the new directory you just
created:

A:\>copy *.* c:\tpl Press

That's all you need to do!



RUNNING A T PROGRAM

This is an example of a simple T program:

% the first program

const x := 2
const y := 4

program

var sum : int

sum := x + y
put x, " +", y, " =", sum

end program


Enter this program, and run it using the instruction which
follow.

The first step is to start the editor (change to the T
directory if necessary):

C:\TPL>te Press

Note that "F10 Help" appears in the upper right of the
screen, this means that the F10 function key is used to call
a pop-up menu of built-in help information which you may
need. Try pressing the F10 key on the top row of your
keyboard to see what happens.

The up and down arrow keys on your keyboard can be used to
select an item from the menu. The item highlighted in WHITE
is the item selected. To activate it, press the
key. Try these out also. To exit from the menu, just press
the key which is usually placed at the upper left
corner of your keyboard.

Now select the item named "keyboard"; this one explains how
the keyboard is used as a typewriter to enter text into a
file. Study it before you begin to enter the sample program
above.

Enter the sample program into the computer. After you have
finished, press the F1 key. On the pop-up menu select
"Write to." Type a name for your program. How about
"first.t"? Note the ".t"; this is the file name extension
used by the editor to identify T programs. Press
when you've finished. At the top of the edit screen, the
"UN_NAMED.T" should disappear and be replaced with the name
you typed.

Now press the F3 key and select "Debugger" on the pop-up
window. When you press enter, the editor will save your
file and start the interpreter in its debugging mode using
your file as source code. If you entered correct code you
should see your file with a gray bar highlighting the first
line of your code.

If you entered incorrect code you will see an error message.
If this happened, press F3 again and select "Errors" and
press . The editor will show you where the errors
are. Each line containing an error will be highlighted and
the cursor will point to the error. Sometimes the editor
will point to the symbol or word just after the error. The
bottom line of the screen will contain a short message
describing the error.

Let's assume that either you entered the program correctly
or you corrected any errors and started the interpreter
again in the debugging mode. Press the spacebar. The
highlight will jump to the next line containing a statement.
Keep doing this until the interpreter gives you a "Success"
message. Each line containing an executable statement was
highlighted. The debugging mode of the interpreter has more
features; try starting the debug mode again as we did above.
Press F10 again. The pop-up window shows the all the debugging
options and the corresponding function keys. You should try
them out.


COMMAND LINE OPTIONS

The T interpreter programs can be run directly from the DOS
prompt. Try the following:

C:\TPL>te first.t Press

The editor should start up and immediately load "first.t" if
it is in the directory. Now quit the editor and try the
following:

C:\TPL>ti first.t debug Press

The interpreter should run in debug mode. Now try:

C:\TPL>ti first.t Press

The program should run. Note that a program can be halted
by pressing the key.

The language reference program can be run from the DOS
command line as well as from the editor. Try:

C:\TPL>th Press

Use the arrow keys to select a menu item then press .
Pressing any key returns to the language menu. Pressing
quits the language help program.

Several sample programs have been included with the T
interpreter software for your use in learning the T
programming language.


REGISTRATION

I hope that you are pleased with this shareware and decide to register it.
To register, send $30 to:

Stephen R. Schmitt
962 Depot Road
Boxborough, MA 01719

You will receive a printed user's manual.