| | 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.) |