home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 7 Games / 07-Games.zip / tadsos2.zip / tadsos2.doc next >
Text File  |  1997-10-25  |  12KB  |  239 lines
  1. TADS/2 1.0.0 - The Text Adventure Development System (TADS) runtime for OS/2.
  2. Copyright (c) 1997 Stephen Granade.
  3. All rights reserved.
  4.  
  5. -----=======-----
  6. Table of Contents
  7. -----=======-----
  8. 1. What is TADS/2?
  9. 2. What is TADS?
  10. 3. How do I run games with TADS/2?
  11. 4. What are the basic menu options of TADS/2?
  12. 5. What are macros, and how do I use them?
  13. 6. What special keys does TADS/2 recognize?
  14. 7. Could you explain the TADS/2 settings?
  15. 8. What's this "bound game" business?
  16. 9. What are those extra files TADS/2 created?
  17. 10. Who helped you with this?
  18. 11. How can I reach you?
  19.  
  20.  
  21. -----========-----
  22. 1. What is TADS/2?
  23. -----========-----
  24. TADS/2 is the OS/2 PM port of the TADS runtime. With TADS/2 you can run any
  25. text adventure game written using the TADS programming language. Thus TADS/2
  26. is not a game per se; it is a program for running games. TADS game files are
  27. easily recognized by their .gam extension.
  28.  
  29.  
  30. -----======-----
  31. 2. What is TADS?
  32. -----======-----
  33. TADS is a design system for writing text adventures. It was created by Michael
  34. Roberts. TADS consists of a compiler, a library to make text adventure writing
  35. easier, and a runtime. A debugger is also available, though under MS-DOS and
  36. not OS/2 specifically.
  37.  
  38. The TADS language and many TADS adventures are available from the interactive
  39. fiction archive at GMD. The TADS development system is located in the
  40. directory ftp://ftp.gmd.de/if-archive/programming/tads; TADS games are located
  41. in the directory ftp://ftp.gmd.de/if-archive/games/tads.
  42.  
  43.  
  44. ------------==========------------
  45. 3. How do I run games with TADS/2?
  46. ------------==========------------
  47. One of three ways:
  48.  
  49. 1) Start TADS/2. Select "Load .gam file" from the "File" menu (or press
  50. CTRL-L). TADS/2 will ask you to select the .gam file.
  51.  
  52. 2) Drag and drop the .gam file on the TADS/2 program.
  53.  
  54. 3) Create an association which links .gam files with TADS/2.
  55. Right-click on the TADS/2 program and select "Properties". Choose the
  56. "Association" tab and type "*.gam" into the "New name" entry field.
  57. Press the "Add >" button. Then, whenever you double-click on a .gam file,
  58. TADS/2 will automatically load it.
  59.  
  60.  
  61. ----------------=============----------------
  62. 4. What are the basic menu options of TADS/2?
  63. ----------------=============----------------
  64. File
  65.   Load .gam file:        Loads a TADS game file and runs it
  66.   Save game:             A shortcut for saving a game while in the middle of it
  67.   Restore game:          A shortcut for loading a previously saved game
  68.   Bind standalone game/Unbind TADS/2: See "What's this 'bound game' business?"
  69.     below.
  70.   Quit:                  Quit the game
  71. As you play games, they will be added to the File menu between the Bind game
  72. and Quit menu items. This is the "most recently played" list. Up to ten
  73. games will be stored this way. Selecting one of these games will re-load
  74. and run the game.
  75.  
  76. Edit
  77.   Undo:                    Undo your last move during a game
  78.   Cut:                     Copy the selected text to the clipboard and remove
  79.                            it. Note that the text will be removed only if
  80.                            _you_ typed it
  81.   Copy:                    Copy the selected text to the clipboard
  82.   Paste:                   Paste text from the clipboard to the game
  83.   Find:                    Search for text
  84.   Find again:              Search for the previously-searched-for text
  85.  
  86. Options
  87.   Story window settings:   Set the characteristics of the story window
  88.   Interpreter settings:    Set the behavior of the TADS interpreter engine
  89.   Program settings:        Set how the program behaves
  90.   Set font
  91.     Set main window font:  Set the main window font
  92.     Set status window font: Set the status window font
  93.   Set colors:              Set the window colors. This option opens the color
  94.                            palette. Drag the color you want to the window;
  95.                            TADS/2 will ask you if you want that color to be
  96.                            the foreground (text) color or the background color
  97.   Separated status bar:    The status bar can be part of the main TADS/2
  98.                            window or a window of its own; your choice.
  99.  
  100. Macros: see "What are macros, and how do I use them?" below
  101.  
  102.  
  103. ---------------============---------------
  104. 5. What are macros, and how do I use them?
  105. ---------------============---------------
  106. Good question. Macros are designed to save you from having to type things over
  107. and over and over and over and... Macros can be assigned to the twelve
  108. function keys.
  109.  
  110. To assign a macro, select some text using the mouse. Either choose "Define
  111. macro" from the Macro menu or press CTRL-D. Then press the function key to
  112. which you want the macro defined. Then, to use the macro, press that function
  113. key. If you start to define a macro and change your mind, press CTRL-D again
  114. to cancel the macro define.
  115.  
  116.  
  117. ---------------=============---------------
  118. 6. What special keys does TADS/2 recognize?
  119. ---------------=============---------------
  120. Escape erases anything you've typed on the current command line. Up and Down
  121. Arrow will scroll through the previous commands you've typed. PageUp and
  122. PageDown scroll the entire text window up and down by a page; Ctrl-Up Arrow
  123. and Ctrl-Down Arrow scroll the text window up and down by one line. Left Arrow
  124. and Right Arrow move the cursor through the text. Home takes you to the
  125. beginning of the command line and End takes you to the end of the command
  126. line. Ctrl-Home moves you to the top of the text window; Ctrl-Down moves you
  127. to the bottom.
  128.  
  129. Holding shift while using Left/Right Arrow, Ctrl-Left/Right Arrow, Home,
  130. or End keys will move the cursor and select text.
  131.  
  132.  
  133. --------------=============--------------
  134. 7. Could you explain the TADS/2 settings?
  135. --------------=============--------------
  136. Sure.
  137.  
  138. Story Window Options
  139.   Left/right margins:      The margin (in pixels) between the left/right side of
  140.                            the text and the border of the window. The margin
  141.                            can be between 0 and 99 pixels
  142.   Top/bottom margins:      The margin (in pixels) between the top/bottom of the
  143.                            text and the border of the window. The margin can
  144.                            be between 0 and 99 pixels
  145.   Justify text:            If checked, the game text will be full-justified
  146.   Bold input:              If checked, your input to the game will be in bold
  147.   Two spaces after period: TADS normally puts two spaces after each period. If
  148.                            you don't like that, leave this box unchecked.
  149.  
  150. Interpreter Options
  151.   Command history length:  How many commands you want TADS/2 to keep track of.
  152.                            Can be between 2 and 99 commands.
  153.   Buffer size:             The number of characters output by the game that
  154.                            TADS/2 keeps track of before it begins throwing
  155.                            them away. Can be between 400 and 30000 characters.
  156.   Buffer slack:            The number of characters over the buffer size that
  157.                            TADS/2 is willing to remember before throwing away
  158.                            characters. This is to allow TADS/2 to throw away
  159.                            one line at a time, or at worst one word at a time.
  160.                            This can be between 100 and 5000 characters.
  161.   Pause while paging:      Should TADS/2 pause between screens of text or
  162.                            scroll all the way to the bottom without stopping?
  163.   Clear by scrolling:      Should TADS/2 clear the screen by printing a bunch
  164.                            of blank lines, or should it instead get rid of all
  165.                            the text previously printed?
  166.  
  167. TADS/2 Options
  168.   F1 is a macro:           Normally F1 brings up a program's help. Since
  169.                            TADS/2 has no help implemented yet, this means that
  170.                            F1 would do nothing. Instead, you can check this
  171.                            box and let F1 be a macro instead. Any changes you
  172.                            make to this won't take effect until next time you
  173.                            run TADS/2.
  174.   F10 is a macro:          F10 normally highlights the menu bar. (If you don't
  175.                            know what I mean by this, uncheck this box, quit
  176.                            TADS/2, rerun it, and press F10.) However, you can
  177.                            make F10 be a macro key instead. Any changes you
  178.                            make to this won't take effect until next time you
  179.                            run TADS/2.
  180.   Sticky paths:            Sticky paths means that TADS/2 remembers the last
  181.                            directories where you saved or restored a game and
  182.                            where you loaded a .gam file.
  183.   Sticky macros:           Sticky macros means that TADS/2 remembers the
  184.                            macros you defined from session to session.
  185.   Close when ending a game: If checked, TADS/2 quits when the game ends. If
  186.                            unchecked, TADS/2 won't quit, allowing you to run
  187.                            several games in succession.
  188.  
  189.  
  190. ------------=============------------
  191. 8. What's this "bound game" business?
  192. ------------=============------------
  193. TADS/2 has the ability to create another copy of itself with a .gam file
  194. bound to it, thus making the adventure game a self-executing program. If
  195. your copy of TADS/2 is not bound to a game, when you load a game you can
  196. select "Bind stand-alone game" from the File menu to make a stand-alone
  197. or "bound" game. If your copy of TADS/2 is already bound, you can select
  198. "Unbind TADS/2" from the File menu to make a separate, unbound copy of TADS/2.
  199.  
  200.  
  201. ----------------=============----------------
  202. 9. What are those extra files TADS/2 created?
  203. ----------------=============----------------
  204. TADS/2 creates two different types of files. The first is the file
  205. "TADSOS2.INI," in which TADS/2 records all of your settings. The second are
  206. files which look something like "sw635561.000". These are swap files, which
  207. TADS/2 creates while running an adventure in order to keep memory overhead
  208. low. Normally TADS/2 deletes these files when it is done; however, if you
  209. cancel TADS/2 in the middle of a game, then one (or more) of these files
  210. will be left in TADS/2 directory. You can delete them without worry after
  211. you quit TADS/2.
  212.  
  213.  
  214. ----------========----------
  215. 10. Who helped you with this?
  216. ----------========----------
  217. Oh, lots of people. The two major people who must be thanked are Mike Roberts
  218. and Andrew Plotkin. Mike created TADS in the first place; if it weren't for
  219. him, I'd have never renewed my interest in adventure games. Andrew wrote the
  220. Macintosh TADS interpreter "MaxTADS". I took much of MaxTADS' interface and
  221. text-handling code and warped it to my own nefarious purposes.
  222.  
  223. Gerhard Hoogterp, Heiko Nock, Lon Thomas, and Adam Thornton tested TADS/2 in
  224. its various forms. They are responsible for many of the good features of the
  225. TADS/2 interface.
  226.  
  227. TADS/2 was compiled using GCC and the EMX libraries.
  228.  
  229. If you have suggestions on how to improve TADS/2, please let me know. I'll
  230. be sure to add you to this list.
  231.  
  232.  
  233. --------========--------
  234. 11. How can I reach you?
  235. --------========--------
  236. The best way is by e-mail. I can be reached at sgranade@iname.com and at
  237. sgranade@phy.duke.edu until some time after 2001. Beyond that, your guess
  238. is as good as mine.
  239.