-------------------------------------------------
Please read http://dead-souls.net/ds-inst-faq.html
--------------------------------------------------

This is a "patch" for upgrading version 2.0r21 of Dead Souls
to version 2.3a9. It will also upgrade any version between
those two levels to 2.3a9.

In this directory is a directory containing the files that
have been changed. It can be installed on a running
mud, but it is strongly recommended that you reboot
the mud after installation.

After installation, the mud should shut down a couple
of time automatically. This is a normal part of the
upgrade process. If it doesn't start back up automatically,
restart it manually.

UNIX Installation steps:
-----------------------

* you may want to su to root, to make sure you have
  adequate read/write privs to the files.

* unzip the patch archive to a temp directory:
  unzip -qd dspatch_2.0r21_2.3a9 dspatch_2.0r21_2.3a9.zip

* cd to your mud directory (where the lib/, bin/,
  and v22.2b14/ directories are)

* back up your current lib. A good command might
  be: tar cfp lib_pre_2.3a9.tar lib

* cd to the patch directory and type:
  tar cf lib.tar lib

* copy the lib.tar file from the patch dir into the
  mud directory.

* cd to the mud directory and type:
  tar xf lib.tar 

* If you did this as root, use the chown command to
  reset the ownerships. See the FAQ at the top of
  this page for details.

* You may need to recompile a new version
  of the driver. Because the driver source
  has changed, you should download the current
  version, compile it as if you were installing
  a new mud, then copy that driver binary over
  your current driver binary. See the URL
  above for a link to the download. This step
  is probably not *essential* but you'll be glad you did.

* When finished, reboot the mud.

* If this breaks things for you, you can
  restore the way you used to run, by issuing
  commands like this:
  - mv lib lib_screwed
  - tar xf lib_pre_2.3a9.tar

* If this is hard to follow or understand,
  avoid doing it, and perform a clean reinstall
  of your mud with the full version of 2.3a9


* THIS IS FOR UPGRADES ONLY, NOT FOR NEW INSTALLS.


Windows Instructions:
--------------------

* Shut down the mud.

* back up your current c:\ds\lib folder. Even just
  copying it somewhere else is better than nothing.

* use windows explorer to copy the "lib" folder in
  the patch over the "lib" folder in c:\ds

* "overwrite all"

* Copy the driver.exe in the folder win32 of the patch
  into the win32 folder of your mud.

* Start the mud. 


* THIS IS FOR UPGRADES ONLY, NOT FOR NEW INSTALLS.


