This file contains Amiga-specific information about the TADS system, version
2.2.1.0, based on the Unix release. For general information about TADS, see
the other documentation files included in this package. TADS consists of 3
parts, the compiler, the debugger and the player. Most games are distributed
as compiled games (files ending in ".gam"), for which only the player is
required. The compiler is used to build compiled games from their source
(files ending in ".t"). You should only need to use the compiler and
debugger for writing your own games. Lots of TADS games can be found on the
Internet at the ftp site ftp.gmd.de in the directories

	/if-archive/games/tads
and	/if-archive/games/adventions

The full TADS package for many different machines can be found at the same
site, in

	/if-archive/programming/tads

Kickstart 2.04 or better is required for this version of TADS.

Using the TADS player
---------------------

The player for adventure games created with TADS is called "TADS Run-time"
on the Amiga (it is also commonly refered to as "tr" or "TADSr" in document-
ation for other systems). To run a TADS game, double click on the
"TADS Run-time" icon, then select the game file (usually ending in ".gam")
with the file requester. The icon can have the following tootypes:

DIR	  This indicates which directory TADS should open the file
	  requester in, e.g.
				DIR=Cheez:TADSGames/

SWAPDIR	  This is the directory to store temporary swap files. The
	  default is T:

The player can also be used from the Shell by giving the game file path as
the first argument, e.g.

	"TADS Run-time" Cheez:TADSGames/UU1.gam

Calling the player without any arguments will give a list of all possible
arguments and their function. Note that the player requires more than the
standard stack to run successfully; the stack in the player's icon is set
to 50000, and if the player is run from the Shell then the Shell's stack
should be set to at least as much.

The player has command line editing (cursor left/right, delete and back-
space), a command line history (cursor up/down to go through the previously
entered commands) and a review mode (accessible by pressing F1) in which
text that has scrolled off the display can be recalled.

There is also a version of the player, called "tr", which only uses standard
input and output, for use in a Shell window or over a network.

Using the TADS compiler and debugger
------------------------------------

The compiler for TADS games is called "tc" (on other systems it is sometimes
refered to as "TADS Compiler" or "TADSc"), and may only be run from the
Shell. The compiler requires more than the default stack: For "Ditch Day
Drifter" (the included sample game) 30000 is enough, but for serious work I
would recommend a larger stack (say 100000). There is also a debugger
available, called "tdb". For more information on how to use these tools,
see "TADS.doc" and the full manual which is available from ftp.gmd.de in the
directory

	/if-archive/programming/tads/manuals

Contacts
--------

TADS 2.2.1.0 has been ported to the Amiga by David Kinder. If you have any
problems, please report them to me at

	kinder@teaching.physics.ox.ac.uk
or	david.kinder@physics.ox.ac.uk

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  271     628  43.2% -lh5- c821 Nov  3  1996 TADS.info
[generic]                31901  117883  27.1% -lh5- e93b Nov 22  1996 TADS/adv.t
[generic]                  350     723  48.4% -lh5- 941d Nov  3  1996 TADS/adv.t.info
[generic]                 1478    3285  45.0% -lh5- 8036 Nov  3  1996 TADS/Amiga.doc
[generic]                  325     847  38.4% -lh5- 30d2 Nov  3  1996 TADS/Amiga.doc.info
[generic]                 7643   19507  39.2% -lh5- 27e2 Nov 22  1996 TADS/Ditch.doc
[generic]                  327     847  38.6% -lh5- ab8e Nov  3  1996 TADS/Ditch.doc.info
[generic]                65824  118677  55.5% -lh5- ff6a Oct 14  1996 TADS/Ditch.gam
[generic]                  206     488  42.2% -lh5- bc47 Nov  3  1996 TADS/Ditch.gam.info
[generic]                37129  110920  33.5% -lh5- f39a Nov 22  1996 TADS/ditch.t
[generic]                  350     723  48.4% -lh5- 842b Nov  3  1996 TADS/ditch.t.info
[generic]                  749    1674  44.7% -lh5- 7f12 Nov  3  1996 TADS/goldskul.t
[generic]                  349     723  48.3% -lh5- f5c9 Nov  3  1996 TADS/goldskul.t.info
[generic]                 1030    2908  35.4% -lh5- 924b Nov  3  1996 TADS/help.tdb
[generic]                 1260    2776  45.4% -lh5- dc96 Nov  3  1996 TADS/License.doc
[generic]                  327     847  38.6% -lh5- 6cb9 Nov  3  1996 TADS/License.doc.info
[generic]                  699    1327  52.7% -lh5- 8a5b Nov  3  1996 TADS/Read.doc
[generic]                  326     847  38.5% -lh5- 9d62 Nov  3  1996 TADS/Read.doc.info
[generic]                 4547   12214  37.2% -lh5- 668a Nov 22  1996 TADS/std.t
[generic]                  353     723  48.8% -lh5- 9be4 Nov  3  1996 TADS/std.t.info
[generic]                83417  178276  46.8% -lh5- 3bed Nov 22  1996 TADS/TADS Run-time
[generic]                  229     558  41.0% -lh5- c433 Nov  3  1996 TADS/TADS Run-time.info
[generic]                19611   58271  33.7% -lh5- 8a32 Nov 22  1996 TADS/TADS.doc
[generic]                  332     851  39.0% -lh5- f482 Nov  3  1996 TADS/TADS.doc.info
[generic]                91442  192272  47.6% -lh5- ca8f Nov 22  1996 TADS/tc
[generic]               125001  261548  47.8% -lh5- c334 Nov 22  1996 TADS/tdb
[generic]                81042  172872  46.9% -lh5- ff45 Nov 22  1996 TADS/tr
[generic]                56206  163005  34.5% -lh5- 632e Nov 22  1996 TADS/Version.doc
[generic]                  324     847  38.3% -lh5- 660d Nov 20  1996 TADS/Version.doc.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        29 files  613048 1427067  43.0%            Nov 25  1996