cfad47cfa3/doc/COMPILERS

4b825dc642cb6eb9a060e54bf8d69288fbee4904cfad47cfa334b206c65f22086bcc5d63e6f70944
1
The FrobTADS main package does not contain the compilers, so that people
2
only interested in the interpreter won't have to download sources they
3
don't need (the TADS 3 compiler is quite big).  You can download the
4
package of the compiler you're interested in (TADS 2 or TADS 3) from the
5
same place where you got this main package.  You can download both
6
compilers, if you wish.  You need to extract the contents of the
7
compiler packages into the FrobTADS top-level directory.  See below for
8
more information.
9
10
There is no documentation on the TADS programming languages included in
11
any of the FrobTADS packages.  Luckily, the TADS homepage offers
12
various downloads and links:
13
14
http://www.tads.org
15
  The TADS homepage; has the latest news, updates and documentation for
16
  everything TADS-related.
17
18
http://www.tads.org/t3doc/doc
19
  The TADS 3 Bookshelf.  Everything you need to know about writing IF
20
  in TADS 3 can be found there.  A must-visit.  It contains various
21
  books, browsable online (HTML) and downloadable (PDF).
22
23
http://teladesign.com/tads-manual/tadsman.zip
24
  The TADS 2 Author's Manual (HTML format).
25
26
http://www.tela.bc.ca/tads-manual
27
  This leads to the online-version of the TADS 2 Author's Manual.
28
29
30
Unpacking and building
31
======================
32
33
There are no extra configuration steps required to build the compilers.
34
Just unpack them inside the FrobTADS directory and reconfigure the
35
package.  The FrobTADS configuration script will detect the presence of
36
the compiler sources and build them along with the interpreter.  For
37
example, if you previously unpacked FrobTADS in
38
39
  ~/downloads/frobtads-0.11
40
41
and your downloaded TADS 3 compiler package is
42
43
  ~/downloads/frobtads-t3compiler-0.11.tar.gz
44
45
you can unpack the compiler with:
46
47
  cd ~/downloads/frobtads-0.11
48
  tar -xzf ~/downloads/frobtads-t3compiler-0.11.tar.gz
49
50
If you previously configured FrobTADS, you can reconfigure by typing:
51
52
  ./config.status --recheck
53
54
in the build directory in order to use your previously supplied
55
configuration options.  Or you can simply run ./configure again if you
56
want to use different options.
57
58
See the INSTALL file for more information on configuring and compiling.
59
60
61
Invocation
62
==========
63
64
The compilers can be invoked with:
65
66
  tadsc   (TADS 2 compiler)
67
  t3make  (TADS 3 compiler)
68
69
Note that, unlike the interpreter, the compilers don't support GNU-like
70
command line options, which means that "short options" aren't available.
71
For example, use "-help" instead of "--help".  This is to ensure
72
compatibility of compiler command line syntax between different ports.
73
74
For Tads 3, you don't need to specify where the compiler's include files
75
are installed.  But the Tads 2 compiler works different.  When invoking
76
'tadsc', you'll have to use the -i option:
77
78
  tadsc -i /usr/local/share/frobtads/tads2 mygame.t
79
80
(Remember to use the actual path if you installed somewhere else.)