*****************************************************************************
****** Tales of the Traveling Swordsman - Source Code for Version 1.3+ ******
*****************************************************************************

                    Copyright (C)2006-2007 by Mike Snyder

This is the complete source code to Tales of the Traveling Swordsman, the
4th-place finisher in the 2006 Annual Interactive Fiction Competition, and
winner of the XYZZY award for Best Story of 2006.

This is being made available for the benefit of Hugo programmers, but it
is not intended that anyone add to the game, release new games based on it,
or update/release TTS. You are, of course, welcome to swipe whatever bits
of code you might re-use in a completely different game.

Also included are several text (.TXT) files, containing development and
design information -- things like the original story (including two
alternate endings that never made it into the completed version), notes and
maps for each chapter created prior to coding, a to-do list of fixes prior
to the release of version 1.3 and after (plus many more to-do's that have
not yet been done), and an explanation of the score (which is also found in
the official walkthrough .PDF, although that's not included here).

In "journal.txt" I have included notes made before, during, and after the
development of this game. It's lengthy, but included for completeness (and
because there may be useful and interesting information there).

The following command, if adjusted to use your own Hugo Lib and Source paths,
can be used to compile Tales of the Traveling Swordsman. You can use HCWIN
to compile as well, as long as you include the appropriate paths there too.
Definitions for $MAXDICT (set to 1900) and $MAXROUTINES (set to 400) are
also required, but these have been removed from the command line into the
tales_ts.hug source code itself. These shouldn't need changed, since you are
using this for educational purposes only (not to expand the game itself).

HC.EXE -25 @lib=c:\hugo\lib @source=c:\tales_ts tales_ts.hug tales_ts.hex

The entry point is tales_ts.hug. Additional .hug files are supporting code,
including text*.hug files that contain almost all the text in the game. The
"utils.hug" has some custom routines that may be of interest to other Hugo
programmers, and the "newverbs.g/.h" files have new grammar and grammar
extensions that might be useful as well.

I have not included the graphics resource file (TALES_TS with no extension)
or the Gargoyle config file (tales_ts.ini) or the compiled version of the
game (tales_ts.hex) or the player documentation (read_1st.txt), which are
all available separately in the version 1.3 game release download.

I can be contacted at wyndo@prowler-pro.com, or sidneymerk@hotmail.com.
My website for Interactive Fiction is http://www.sidneymerk.com/

---- Mike Snyder
---- 07/05/2007
