
		    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.
 
2) The Adventure and Qork executables are pre-built for macOS, 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. There a several variables specifying the path
to common Unix commands, and while these work for all Linux distros
I tested, you may have to make changes for other variants:

$cmpPath   = "/usr/bin/cmp";
$cpPath    = "/bin/cp";
$lnPath    = "/bin/ln";
$lsPath    = "/bin/ls";
$mkdirPath = "/bin/mkdir";
$rmPath    = "/bin/rm";

########################################################################
IMPORTANT: there is a symbolic link in the bin/ folder pointing to Perl.
If the symlink is not set properly play-text-adventure-games will fail.
The game command files Adventure.command and Qork.command setup this
symlink properly, so please run one of those commands before trying to
run play-text-adventure-games.
########################################################################

    cd TAG
    ./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
    ./platag                # by default play Qork
    ./platag -g Adventure   # play Adventure
    ./platag -s             # manage Qork game save states
    ./platag -l             # simply list all 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                # now, 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
2022.04.01
