FrotzN for the Nokia Communicator 9200 series
---------------------------------------------
An interpreter for all Infocom games. Complies with standard
1.0 of Graham Nelson's specification. Written by Stefan Jokisch in 1995-7 for Dos
and ported to the Psion Series 5 by Frdric Bouvry. Ported to from the Psion code to the Nokia Communicator 9200 series by Simon Quinn, 2002

Getting Games
-------------
A good place to get stories is ftp://ftp.gmd.de/if-archive/games/infocom/
All the stories there ending with .z1 up to .z8 work. Some .z6 games, which rely on graphics, may not work. Also Infocom sometimes use .zip extensions for their z6 games, these work fine with Frotz.
Another way to get stories is to buy compilation CD-Roms like
'The Masterpieces of Infocom': about 21$US for more than 30 stories + the original documentations and maps in Adobe Acrobat .pdf format (Activision who bought Infocom is still selling those compilations).

Version Information
-------------------
v1.9 for Nokia Communicator by Simon Quinn.
You'll probably have some issues running some games due to the size of the Communicator screen.
I've tried using True Type fonts such as NewCourier but the EikonConsole is too buggy and slow with the current version of SymbianOS. So the default, and only font, is the terminal font which looks good but is rather wasteful with the screen.
Crashing problems will most likely be due to lack of memory, the 9210s biggest problem!


Issues
------
When changing the font size, please do the change then exit FrotzN and restart it. Currently the screen is not resizing correctly when the zoom is pressed and may cause the program to crash. This is being looked at.

Limitations in current version: No graphics, no sound. Most games need between 300 and 800 Kbytes of RAM so if one doesn't start it is possible you don't have enough free memory.



Install procedure:
------------------
Just install the SIS file.
Put your games into the D:\Frotz directory, or whereever. That's it!

The first time you open a story, save a game or restore a game, you will have to browse to the folder you created but after that, Frotz will remember them. Please remember, you need to open the game before doing a restore inside the game, you cannot simply open a game save.



Thanks
------
Thanks to Stefan Jokisch, the author of Frotz, for giving his sources (Dos Frotz v2.32).
Thanks to Frdric Bouvry for the Psion code and his help to me.



Documentation from Stefan Jokisch:
----------------------------------------------------------------
FROTZ V2.32 - an interpreter for all Infocom games. Complies with standard
1.0 of Graham Nelson's specification. Written by Stefan Jokisch in 1995-7
    This program once started as a re-make of Mark Howell's Zip, but
    has grown into an utterly new interpreter.

    Frotz is freeware: It may be used and distributed freely provided
    no commercial profit is involved. (c) 1995-1997 Stefan Jokisch.

Special keys:

    Ctrl-D - toggle debugging options
    Ctrl-S - help on hot keys
    Ctrl-N - new game (restart)
    Ctrl-P - turn on input line playback
    Ctrl-R - toggle input line recording on/off
    Ctrl-U - multiple undo, works even for old V1 to V4 games
    Ctrl-X - exit game

Psion Shortcuts are displayed in the menu of FrotzS5 like e.g.:
    Ctrl-E - exit from FrotzS5

Other keys:
    cursor left         - move one character to the left
    cursor right        - move one character to the right
    arrow  left         - move one word to the left
    arrow  right        - move one word to the right
    home                - move to beginning of line
    end                 - move to end of line
    backspace           - delete character to the left
    shift-delete        - delete character below cursor
    escape              - delete whole input line
    cursor up           - get previous command
    cursor down         - get next command
    tab                 - word completion (like "tcsh" under Unix)
			  e.g.: 'exa' then TAB displays 'examine'

    When you need to type an unpleasantly long word, try to type the
    first three or four letters then press the tabulator key. If you
    are lucky, Frotz fills in some or all of the missing letters. A
    high beep noise indicates that the word is ambiguous; a low beep
    indicates that it does not exist. Apart from that, you can also
    use the history feature to get to previous input lines. Type the
    beginning of the input line you are looking for, then use cursor
    up/down to scroll through all input lines matching that prefix.
    e.g: type 'lo' then arrow up/down to retrieve all the commands
    that you entered that begin with the letters 'lo'.
    Note: No beep in the Psion Series 5 version.

Questions and answers:

    Q: What is Frotz?
    A: Frotz runs text adventures which come in so-called story files:
       ZORK1.DAT, TRINITY.DAT, CURSES.Z5, JIGSAW.Z8, ARTHUR.ZIP etc.

    Q: Where can I find story files to use with Frotz?
    A: First, you can use the files from your original Infocom games. It
       is possible to play Atari ST, Amiga or Macintosh games on your PC
       once you manage to transfer the story files. Some people even
       extracted story files from old Atari 800, Apple II and C-64 disks
       (ask your local 8bit guru). Second, there is an increasing number
       of new games available on the Internet. Check the if-archive at
       ftp.gmd.de.

    Q: Why does Frotz stop with an error message?
    A: It might have detected a bug in the story file other interpreters
       overlooked. It's also possible that the story file is corrupt;
       be sure to download story files in binary mode, especially when you
       use a WWW browser.


List of fatal errors:

    - "Bad stack frame"
    - "Byte swapped story file"
    - "Call to illegal address"
    - "Call to non-routine" [1]
    - "Cannot open story file"
    - "Division by zero"
    - "Error reading save file"
    - "Illegal attribute"
    - "Illegal object" [2]
    - "Illegal window"
    - "Illegal window property"
    - "Jump to illegal address"
    - "Nesting stream #3 too deep"
    - "No such property"
    - "Out of memory"
    - "Print at illegal address"
    - "Stack overflow" [3]
    - "Stack underflow" [4]
    - "Store out of dynamic memory"
    - "Story file read error"
    - "Text buffer overflow"
    - "Unknown opcode"
    - "Unknown Z-code version"

    [1] The first byte of a routine must be less than 16.
    [2] In V4 and above, object numbers > 2000 are considered illegal.
    [3] Checked on every call instruction.
    [4] Checked on every return from a subroutine.

    [1] Underlined text is shown in emphasis colour (-e switch).
    [2] Boldface text is available using the -T switch.
    [3] ISO Latin 1 characters are replaced with suitable substitutes.

Acknowledgements:

    Many thanks to Paul D. Doherty for his continuing support of this
    project. Thanks to everyone who sent bug reports, contributions or
    helpful hints (in alphabetical order):

    Thomas Biskup, Ian Carpenter, Graeme Cree, Jason Dyer,
    Carl Edman, Julian Eggebrecht, Bernhard Fuchs, Joe Hachem,
    John Kennedy, Kirk Klobe, Marnix Klooster, John Mackin,
    Paul O'Brian, Magnus Olsson, Barry Prescott, L. Ross Raszewski,
    Ambat Sasi Nair, Alan Sherrod, Linards Ticmanis and Paolo Vece.

    Last but not least, thanks to the porters:

    David Kinder (Amiga), Rich Lawrence (Windows 95/NT),
    Andrew Holdsworth (RiscOS), Christos Dimitrakakis (HP-UX),
    Christopher J. Madsen (OS/2), Galen Hazelwood (Unix curses library),
    Ian Dean (Windows CE)... Note: ( I should come here :-) Fred)

    Executables are available from ftp.gmd.de and from

	http://www.geocities.com/SiliconValley/Heights/3222/frotz.html

    which is the Frotz home page maintained by Chris Madsen.


FrotzN disclaimer:
This port of Frotz is freeware, that means:
-You may not make money with this software by selling it or by any other way.
-If you want to put this software on a CD-Rom compilation, email me before
 to get my agreement. It shouldn't be a problem if you don't charge too much
 money for the compilation.
-You may not modify the original files.
-I'm not responsible for any damage this program could cause to your palmtop 
 or yourself.
-But you can play for free and copy it for friends as long as you copy all
 the files included in this distribution.
