
		    Welcome to Adventure and Qork!

0) Qork is a modified version of Dungeon, similar but different, with
at least one new room and 550 points. There is no Puzzle Room, which
indicates that this code was born around September 1978. There is an
End Game, but it's unique to Qork.

Adventure is Adventure AFAIK, although the max score is 366 instead of
the usual 350.

1) Use the Perl script play-text-adventure-games (platag) to play the
games, but if you move the script to another location be sure to
change the "use lib" statement, which is a relative pathname for
locating EvaP.pm, to a proper absolute path.

2) The Adventure and Qork executables are pre-built for Mac OS X, so
skip to Step 3) if that describes you. For other operating systems run
play-text-adventure-games one time for each game with -build-game YES
to build the executable, which is then run to create the text database
and the initial game save state.  You can use -f77-compiler to choose
either the GNU, Intel or PGI compiler, but will likely need to make a
script change in subroutine pick_compiler_path to find your copy of
the FORTRAN 77 compiler.

    cd TAG-1.0
    ./play-text-adventure-games -game Adventure -build-game yes
    ./play-text-adventure-games -game Qork      -build-game yes

3) From then on run play-text-adventure-games with -build-game NO (the
default) to play a game.  By default the game save states are stored
in ~/.TAG, which you may change via the parameter
-game-save-states-folder (-gssf). Use -manage-game-save-states (-s) to
restore or delete game save states.

    cd TAG-1.0
    ./platag                # by default play Qork
    ./platag -g Adventure   # play Adventure
    ./platag -s             # manage Qork game save states

4) Finally, use "./platag -full-help” to see all command line
parameters.  Note that most parameters have an associated environment
variable that you may use to override the parameter's default value:

    export D_PLATAG_G=Adventure
    ./platag                # by default play Adventure

5) OK, I fibbed on the finally.  Speaking of game save states, they
are perfectly portable between various TAG installations. For
instance, you could start a game of Adventure or Qork built with the
Intel compiler on a CentOS machine. Later on you could transfer the
game save state file to, say, a Macintosh computer running Yosemite,
and resume game play exactly where you left off, even if using an
executable of the game built with the GNU compiler.

Steve Lidie, TAG Implementer
lusol@icloud.com
2015.04.01
