home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d834 / pinfocom.lha / PInfoCom / README < prev    next >
Text File  |  1993-03-13  |  7KB  |  196 lines
  1.  
  2.                 Portable Infocom Datafile Interpreter
  3.                 -------------------------------------
  4.  
  5. This package is a public-domain implementation of a Zork Interpretive
  6. Program (ZIP).  No Infocom Inc. proprietary or otherwise protected
  7. code was used to create this program.
  8.  
  9. Note that only standard series Infocom games can be actually played
  10. with this interpreter although it can print informational text about
  11. any Infocom game.
  12.  
  13. Although this interpreter is free, the data files needed to use it are
  14. are still very much covered under copyright.  See the man page for
  15. more details.
  16.  
  17. This interpreter is based on an early revision of the InfoTaskForce
  18. interpreter.  It has been extensively modified seperately from ongoing
  19. work by the ITF.  The current ITF interpreter version is 4.01 and
  20. supports all Z-Code versions except 6 (Graphical).  However, I feel
  21. that this version is less buggy, easier to extend, and contains
  22. more features than 4.01 (IMHO, of course :).  I suggest you use this
  23. version for playing Z-Code v.3 games, and ITF 4.01 for v.4 and v.5
  24. games.
  25.  
  26.  
  27. FEATURES
  28. --------
  29.  
  30. The following features are supported by the interpreter for all
  31. Infocom games:
  32.  
  33.   - Display of game header information, including release/serial
  34.     number info, interpretations of various flags, and offset info.
  35.  
  36.   - Display of complete vocabulary (includes support for alternate
  37.     character sets, needed in Shogun for example).
  38.  
  39.   - Display of all objects, their attributes and link information.
  40.  
  41.   - Display of all objects in a "contained" tree format.
  42.  
  43.   - Verifying the data file is not corrupted
  44.  
  45. Additionally, the following features are supported for playing all
  46. Standard Series (Z-Code version 3) games:
  47.  
  48.   - Save/Restore (restore accepted from the command line as well)
  49.   - Paging long output
  50.   - Different screen sizes
  51.   - Script generation to a printer (if available) or a text file
  52.   - In-game modification of most command-line options
  53.  
  54. The following additional features are supported for playing Standard
  55. series games on UNIX systems:
  56.  
  57.   - Support for termcap or terminfo
  58.   - Support for termio, termios, or stty line discipline control
  59.   - Optional support for GNU readline command line editing and history
  60.       - Line editing
  61.       - History and history file storage
  62.       - User-defined command completion
  63.       - Filename completion
  64.   - Status line printing
  65.   - Fixed windows (used in _Seastalker_) for terminals supporting
  66.     scrolling regions (e.g., vt100)
  67.  
  68. The following additional features are supported for playing Standard
  69. series games on Amiga systems:
  70.  
  71.   - Status line printing
  72.   - Sound support
  73.   - Proportional font support
  74.   - Fixed windows (used in _Seastalker_)
  75.   - Support for command line editing and history
  76.   - Function key command assignment
  77.   - Support for Kickstart 1.2 and 1.3
  78.   - Executable saved game files, w/ all options stored
  79.   - Advanced features for Kickstart 2.04 and above:
  80.       - Pull-down menus
  81.       - Point & click interface for saving and restoring
  82.         games and scripting
  83.       - Games can be restored by dropping their icons on
  84.         the interpreter window
  85.       - Selecting the `About' menu item will display
  86.         information on the current game
  87.  
  88. The following additional features are supported for playing Standard
  89. series games on MS-DOS systems:
  90.  
  91.   - Status line printing
  92.   - Support for color monitors
  93.   - Fixed window support (used in _Seastalker_)
  94.  
  95.  
  96. Compiling
  97. ---------
  98.  
  99. To compile have a look at the Makefile and set the make variables in
  100. the initial section to what you wish, then run make.
  101.  
  102. If your system does not have a supported terminal interface, your only
  103. choice currently is to use TERMTYPE=stream and get simple stream-based
  104. I/O: this means only traditional C stdio routines are used for output,
  105. so you don't get fancy things like a status line.
  106.  
  107. If your system is not supported and you would like to *make* it
  108. supported, you can always write a terminal interface yourself!  If you
  109. would like to write a new interface *please* contact the current
  110. maintainer first, to avoid duplication of effort.
  111.  
  112. Hopefully the terminal interface is now fairly stable.  See the
  113. pinfo_ti(3) man page (or pinfo_ti.txt in the distribution), and
  114. examine the current interfaces for some hints and ideas.  Since
  115. stream.c is the simplest interface, start there.  If you have comments
  116. on the clarity and/or details of the man page or comments, please let
  117. me know.
  118.  
  119.  
  120. Systems
  121. -------
  122.  
  123. This version of the portable Infocom interpreter has been tested on:
  124.  
  125.     DG AViiON               DG/UX (4.32, 5.4.1, 5.4.2)
  126.     Sun                     SunOS (4.1, 4.1.1, 4.1.2)
  127.     MIPS                    BSD 4.2
  128.     NeXT
  129.     Amiga
  130.     IBM & compatibles       MS-DOS, BSDI-386
  131.  
  132.  
  133. ACKNOWLEDGEMENTS
  134. ----------------
  135.  
  136.   - The original version of this code was written by the
  137.     InfoTaskForce.  The source of this code is ITF version REV_C (see
  138.     the _history.txt_ file in the ITF distribution for more info).
  139.  
  140.   - The MS-DOS terminal interface was written and contributed by Mike
  141.     Threepoint <linhart@remus.rutgers.edu>.
  142.  
  143.   - The Amiga terminal interface was written and contributed by Olaf
  144.     Barthel <olsen@sourcery.mxm.sub.org>.
  145.  
  146.   - The original idea/code for the GNU Readline command-completion stuff
  147.     was contributed by Daniel Sharpe <dpsharpe@eos.ncsu.edu>.
  148.  
  149.   - Special mention for tons of info on Z-Code, game versions, etc., plus
  150.     many suggestions for interpreter enhancements to Paul David Doherty
  151.     <h0106kdb@rz.hu-berlin.de>.
  152.  
  153.   - Also thanks to Mark Howell <howell_ma@movies.enet.dec.com> for his
  154.     Z-Code disassemblers; they were quite helpful.
  155.  
  156.   - Thanks to my beta-testers for their patience, especially (in
  157.     alphabetical order :) --
  158.  
  159.       Olaf Barthel
  160.       Paul Close
  161.       Doug DeJulio
  162.       Paul David Doherty
  163.       Glenn Geers
  164.       Tom Phelps
  165.       Daniel Sharpe
  166.       Mike Threepoint
  167.       Luis Torres
  168.       Mike Wiese
  169.  
  170.  
  171. This code was written using information gleaned from the following
  172. articles:
  173.  
  174.   - IEEE Computer, Apr 1979, "Zork: A computerized fantasy simulation
  175.     game", by David Lebling, Marc Blank, and T. Anderson.
  176.  
  177.   - Creative Computing, Jul 1980, "How to fit a large program into a
  178.     small machine", by Marc Blank and Stu Galley.
  179.  
  180.   - Byte, Dec 1980, "Zork and the future of Computerized Fantasy
  181.     Simulations", by David Lebling
  182.  
  183. Also consulted were the following programs:
  184.  
  185.   - zorkword v7, by Mike Threepoint <linhart@remus.rutgers.edu>, for
  186.     information on alternate alphabets and the structure of the object
  187.     info list for Z machine versions 4, 5, and 6 data files.
  188.  
  189.   - zmachine v2.24, by Matthias Pfaller <leo@marco.de>, for
  190.     information on setting/resetting the terminal mode under TERMCAP.
  191.  
  192.  
  193. Local Variables:
  194. mode:   Text
  195. End:
  196.