home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 889 / FrotzS5.SIS / FrotzS5.txt < prev   
Encoding:
Text File  |  2000-09-25  |  11.6 KB  |  249 lines
  1. FrotzS5 V1.6 - an interpreter for all Infocom games. Complies with standard
  2. 1.0 of Graham Nelson's specification. Written by Stefan Jokisch in 1995-7 for Dos
  3. and ported to the Psion Series 5 by FrΘdΘric Bouvry (C) Copyright 1997-1999.
  4. Additional work and bug fixes by Simon Quinn.
  5.  
  6. This port of Frotz is freeware, that means:
  7. -You may not make money with this software by selling it or by any other way.
  8. -If you want to put this software on a CD-Rom compilation, email me before
  9.  to get my agreement. It shouldn't be a problem if you don't charge too much
  10.  money for the compilation, go to http://www.palmtime.com/frotzs5.html for 
  11.  contact information.
  12. -You may not modify the original files.
  13. -I'm not responsible for any damage this program could cause to your palmtop 
  14.  or yourself.
  15. -But you can play for free and copy it for friends as long as you copy all
  16.  the files included in this distribution.
  17.  
  18. A good place to get stories is ftp://ftp.gmd.de/if-archive/games/infocom/
  19. All the stories there ending with .z1 up to .z8 work. Some .z6 games, which rely
  20. on graphics, may not work. Also Infocom sometimes use .zip extensions for their
  21. z6 games, these work fine with Frotz.
  22. Another way to get stories is to buy compilation CD-Roms like
  23. 'The Masterpieces of Infocom': about 21$US for more than 30 stories +
  24. the original documentations and maps in Adobe Acrobat .pdf format
  25. (Activision who bought Infocom is still selling those compilations).
  26.  
  27. Version Information
  28. -------------------
  29. -Official FrotzS5 App UID is 0x1000055B
  30. -Since v1.1 different font sizes can be selected and the toolbar can
  31.  be turned on/off thus the screen width may be less than 80 columns.
  32.  ! The majority of the stories asks to Frotz what's the current number
  33.  of columns then handles this correctly (or just responds 'screen to narrow'
  34.  but this happens rarely). A few stories (well, I know only one:
  35.  A Mind Forever Voyaging) don't handle correctly a screen width under about 70
  36.  columns so you should switch to e.g. mode 70x18 (without toolbar) for AMFV.
  37.  Dynamic font change during a game is currently not possible. Use 'Terminate Story'
  38.  or type 'quit' to change the font size between stories.
  39.  The internal random numbers generator has been improved since v1.1
  40.  ! Some games record the screen width in their private memory space and
  41.  this memory space is saved since your first 'save' operation (e.g.: The HitchHiker's
  42.  Guide To The Galaxy) so you better select you favourite font/screen/toolbar size
  43.  from the beginning or you may get problems with the title when changing the screen
  44.  size and restoring a game started with a different screen size.
  45.  Some games such as Sherlock use the Invisiclues and assume a screen height
  46.  greater than the current one... same problem as AMFV (see above).
  47.  
  48. -Since v1.2 you can put your stories and saved files anywhere. Frotz
  49.  will record in his profile the latest place where you read a story
  50.  and the place where you put the saved games. It works even on 
  51.  drive D: (Compact card).  For owner of previous versions, you don't have to 
  52.  but you can move your C:\Frotz directory anywhere now. After the 
  53.  first 'Open Story', browse to your new folder where you moved your stories 
  54.  open one and Frotz will remember where they are for the next Open. The same 
  55.  applies for the save/restore operations.
  56.  
  57. -Since v1.3 Frotz uses all the screen height of a Geofox palmtop.
  58.  
  59. -Since v1.4 Frotz should now work on any sized screen, such as Revo 
  60.  and Psion7. No toolbar is available on the Revo due to the size of the 
  61.  screen. Changed by Simon Quinn
  62.  
  63. -Since v1.5 Memory usage decreased by 2/3. To do this the number of Frotz undo 
  64.  buffers was reduced from 25 to 2, saving 900Kbytes! Rewrote screen display 
  65.  code for big performance boost.  Cursor keys now work in Journey & Beyond 
  66.  Zork. Fixed key timer problem that was causing Arthur to crash.  Fixed border 
  67.  graphics in Beyond Zork etc. Toolbar buttons tidied up for larger 
  68.  screens. Changed by Simon Quinn
  69.  
  70. -Since v1.6 More speed ups for the screen display code. Fixed major Frotz engine bug 
  71.  when printing inverse text blocks that are taller than the screen, such as 
  72.  in Sherlock. Squashed a few small bugs. Changed by Simon Quinn.  
  73.  
  74. Install procedure:
  75. ------------------
  76. The easiest and best installation is to use the Frotz SIS package. Otherwise 
  77. do the following:
  78.  
  79. The 4 distributed files are FROTZS5.APP, FROZS5.AIF, FROTZS5.RSC and FROTZS5.TXT
  80.  
  81. 1) Make sure you can see the System folder on the Psion by using the check box
  82.    in the System menu -> Tools -> Preferences -> Show 'System' folder.
  83. 2) Create a new folder called 'FrotzS5' under C:\System\Apps thus C:\System\Apps\FrotzS5
  84. 3) Copy all the files from the distribution to this folder with PsiWin.
  85. 4) Create the folders where you will place the stories and save your games.
  86.    e.g.: C:\Documents\Frotz\Story, C:\Documents\Frotz\Save (or even on drive D:)
  87. 5) Put the story files you want to play in the folder you created for them.
  88.    e.g.: C:\Documents\Frotz\Story
  89. 6) Now you should see the FrotzS5 Icon in the Extra Toolbar.
  90. 7) The first time you open a story, save a game or restore a game, you will have
  91.    to browse to the folder you created but after that, Frotz will remember them.
  92.  
  93. N.B.: The application can run on a CF card too, e.g.: D:\System\Apps\FrotzS5
  94.  
  95. Thanks to Stefan Jokisch, the author of Frotz, for giving his sources (Dos Frotz v2.32).
  96. Without him I wouldn't have made this port.
  97. Special Thanks to Ian Dean, the porter of Frotz to the WinCE palmtops (FrotzCE),
  98. for helping me to solve a difficult problem that you should better know when porting Frotz...
  99. Thanks to Steve Richardson for his support and bug reports.
  100. Thanks to David Isherwood for making the runtime help file of FrotzS5 (not yet included).
  101. Thanks to Adam Jackson for beta testing v1.2
  102.  
  103. Supports all games from V1 to V8. Many V6 graphical games work in text mode, such 
  104. as Journey, Arthur and Shogun.
  105.  
  106. Limitations in current version:
  107. No graphics, no sound.
  108.  
  109. Known bugs:
  110. None 
  111.  
  112. Troubles:
  113. -Most games need between 300 and 600 Kbytes of RAM so if one doesn't start it is 
  114.  possible you don't have enough free memory.
  115.  
  116.  
  117. Documentation from Stefan Jokisch adapted to the Psion Series 5:
  118. ----------------------------------------------------------------
  119.  
  120. FROTZ V2.32 - an interpreter for all Infocom games. Complies with standard
  121. 1.0 of Graham Nelson's specification. Written by Stefan Jokisch in 1995-7
  122.     This program once started as a re-make of Mark Howell's Zip, but
  123.     has grown into an utterly new interpreter.
  124.  
  125.     Frotz is freeware: It may be used and distributed freely provided
  126.     no commercial profit is involved. (c) 1995-1997 Stefan Jokisch.
  127.  
  128. Special keys:
  129.  
  130.     Ctrl-D - toggle debugging options
  131.     Ctrl-S - help on hot keys
  132.     Ctrl-N - new game (restart)
  133.     Ctrl-P - turn on input line playback
  134.     Ctrl-R - toggle input line recording on/off
  135.     Ctrl-U - multiple undo, works even for old V1 to V4 games
  136.     Ctrl-X - exit game
  137.  
  138. Psion Shortcuts are displayed in the menu of FrotzS5 like e.g.:
  139.     Ctrl-E - exit from FrotzS5
  140.  
  141. Other keys:
  142.     cursor left         - move one character to the left
  143.     cursor right        - move one character to the right
  144.     arrow  left         - move one word to the left
  145.     arrow  right        - move one word to the right
  146.     home                - move to beginning of line
  147.     end                 - move to end of line
  148.     backspace           - delete character to the left
  149.     shift-delete        - delete character below cursor
  150.     escape              - delete whole input line
  151.     cursor up           - get previous command
  152.     cursor down         - get next command
  153.     tab                 - word completion (like "tcsh" under Unix)
  154.               e.g.: 'exa' then TAB displays 'examine'
  155.  
  156.     When you need to type an unpleasantly long word, try to type the
  157.     first three or four letters then press the tabulator key. If you
  158.     are lucky, Frotz fills in some or all of the missing letters. A
  159.     high beep noise indicates that the word is ambiguous; a low beep
  160.     indicates that it does not exist. Apart from that, you can also
  161.     use the history feature to get to previous input lines. Type the
  162.     beginning of the input line you are looking for, then use cursor
  163.     up/down to scroll through all input lines matching that prefix.
  164.     e.g: type 'lo' then arrow up/down to retrieve all the commands
  165.     that you entered that begin with the letters 'lo'.
  166.     Note: No beep in the Psion Series 5 version.
  167.  
  168. Questions and answers:
  169.  
  170.     Q: What is Frotz?
  171.     A: Frotz runs text adventures which come in so-called story files:
  172.        ZORK1.DAT, TRINITY.DAT, CURSES.Z5, JIGSAW.Z8, ARTHUR.ZIP etc.
  173.  
  174.     Q: Where can I find story files to use with Frotz?
  175.     A: First, you can use the files from your original Infocom games. It
  176.        is possible to play Atari ST, Amiga or Macintosh games on your PC
  177.        once you manage to transfer the story files. Some people even
  178.        extracted story files from old Atari 800, Apple II and C-64 disks
  179.        (ask your local 8bit guru). Second, there is an increasing number
  180.        of new games available on the Internet. Check the if-archive at
  181.        ftp.gmd.de.
  182.  
  183.     Q: Why does Frotz stop with an error message?
  184.     A: It might have detected a bug in the story file other interpreters
  185.        overlooked. It's also possible that the story file is corrupt;
  186.        be sure to download story files in binary mode, especially when you
  187.        use a WWW browser.
  188.  
  189.  
  190. List of fatal errors:
  191.  
  192.     - "Bad stack frame"
  193.     - "Byte swapped story file"
  194.     - "Call to illegal address"
  195.     - "Call to non-routine" [1]
  196.     - "Cannot open story file"
  197.     - "Division by zero"
  198.     - "Error reading save file"
  199.     - "Illegal attribute"
  200.     - "Illegal object" [2]
  201.     - "Illegal window"
  202.     - "Illegal window property"
  203.     - "Jump to illegal address"
  204.     - "Nesting stream #3 too deep"
  205.     - "No such property"
  206.     - "Out of memory"
  207.     - "Print at illegal address"
  208.     - "Stack overflow" [3]
  209.     - "Stack underflow" [4]
  210.     - "Store out of dynamic memory"
  211.     - "Story file read error"
  212.     - "Text buffer overflow"
  213.     - "Unknown opcode"
  214.     - "Unknown Z-code version"
  215.  
  216.     [1] The first byte of a routine must be less than 16.
  217.     [2] In V4 and above, object numbers > 2000 are considered illegal.
  218.     [3] Checked on every call instruction.
  219.     [4] Checked on every return from a subroutine.
  220.  
  221.     [1] Underlined text is shown in emphasis colour (-e switch).
  222.     [2] Boldface text is available using the -T switch.
  223.     [3] ISO Latin 1 characters are replaced with suitable substitutes.
  224.  
  225. Acknowledgements:
  226.  
  227.     Many thanks to Paul D. Doherty for his continuing support of this
  228.     project. Thanks to everyone who sent bug reports, contributions or
  229.     helpful hints (in alphabetical order):
  230.  
  231.     Thomas Biskup, Ian Carpenter, Graeme Cree, Jason Dyer,
  232.     Carl Edman, Julian Eggebrecht, Bernhard Fuchs, Joe Hachem,
  233.     John Kennedy, Kirk Klobe, Marnix Klooster, John Mackin,
  234.     Paul O'Brian, Magnus Olsson, Barry Prescott, L. Ross Raszewski,
  235.     Ambat Sasi Nair, Alan Sherrod, Linards Ticmanis and Paolo Vece.
  236.  
  237.     Last but not least, thanks to the porters:
  238.  
  239.     David Kinder (Amiga), Rich Lawrence (Windows 95/NT),
  240.     Andrew Holdsworth (RiscOS), Christos Dimitrakakis (HP-UX),
  241.     Christopher J. Madsen (OS/2), Galen Hazelwood (Unix curses library),
  242.     Ian Dean (Windows CE)... Note: ( I should come here :-) Fred)
  243.  
  244.     Executables are available from ftp.gmd.de and from
  245.  
  246.     http://www.geocities.com/SiliconValley/Heights/3222/frotz.html
  247.  
  248.     which is the Frotz home page maintained by Chris Madsen.
  249.