Welcome to the alpha version of HSpace release 4.0!

As an alpha tester, you will be an important part in making
HSpace 4.0 a stable and versatile package.

You will need the following things to install this software
package.

1) A new version of PennMUSH with no source code changes.
   We'll be modifying this with the HSpace installation,
   so don't use a PennMUSH copy that you want to hang on
   to!

2) A "newer" version of GNU's gcc compiler or a CC 
   compiler that can handle both C and C++.  If you don't
   know if your compiler can do this, you'll quickly
   find out if you get a screen full of errors when you
   try to compile the software.

   If you're using Windows, you'll need a Windows C/C++
   compiler (e.g. Windows VC++).

3) A newer version of the 'make' program for UNIX (not
   required Windows).  You will need at least version
   3.77, available at ftp.gnu.org/pub/gnu.

4) Patience.  This software is assumed to be unstable and
   containing bugs (hopefully not too many!).  You'll want
   to report all bugs and documentation problems to one
   person and one person only.  That is Kyle Forbes, who
   can be reached directly at kforbes@calmit.unl.edu.


To install this package, do the following:

FOR UNIX:
1) Install pennmush on your computer.  Compile it,
   and make sure you have it running the way you want.
   Now shut down your pennmush game to begin installation
   of HSpace.

2) Copy the hspace_files.tar file to the pennmush/
   directory of your game.

3) Type 'tar -xf hspace_files.tar'.  This will put
   the HSpace source code and _modified_ PennMUSH
   source code files into the proper places.  There
   are minimal modifications to a minimum number of
   PennMUSH files, but just note that we're going
   to be overwriting the following PennMUSH files:

   bsd.c, cmds.c, command.c, flags.c, local.c, funlocal.c
   flags.h

4) Apply the very small patch_hspace40 now located
   in your pennmush/ directory.  It will modify your
   Makefile and src/Makefile to compile in HSpace:

     patch -p0 < patch_hspace40

5) Go into your src/ directory (cd src), and type
   'touch *.c', which will indicate to PennMUSH
   that you want to recompile all of the C files.
   This is necessary so that PennMUSH realizes you've
   put some new command files in.

6) Type 'make' in your pennmush/ directory.  If your
   compiler supports C/C++ together, the source code
   should compile.  There is, of course, the chance
   that it doesn't compile.  If this happens, contact
   Kyle.

6) Reboot your game, and type @space.  HSpace 4.0 should
   give you information about its status.

FOR WINDOWS:
1) Install pennmush on your computer.  You will need a C/C++
   Windows compiler to compile the PennMUSH source code. 
   You cannot install HSpace into a PennMUSH executable
   file.  Check out http://www.pennmush.org for a link to
   Nick Gammon's web page on compiling PennMUSH for 
   Windows.

2) Unpack the hspace_files.tar with whatever decompression
   software you use (Winzip, Aladdin, etc.) to a temporary
   directory.

3) Copy all .c, .cpp and .h files into the directory of your
   PennMUSH source code.

4) For whatever Windows compiler you're using, be sure to
   define the precompiler option -DHSPACE.  In Windows VC++,
   you can do this under your project settings.

5) Recompile the PennMUSH source code with the new files.

6) Copy the hspace.cnf and weapondb files from the hspace_files.tar
   into a directory named "space" in your game/ directory.  The
   game/ directory is whatever directory your PennMUSH executable
   is located in.

7) Reboot your game, and type @space.  HSpace 4.0 should
   give you information about its status.
