TinyMUX 2.0: CONVERSION
Last Update: April 2000

Conversions from Other Database Formats:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
TinyMUX 2.0 has been proven to read the following database formats:
   TinyMUX 1.4, 1.5, 1.6 (not beta)
   TinyMUX(Win32Beta) 1.5, 1.6, 2.0
   TinyMUSH 2.0 (all versions)
   TinyMUSH 2.2.2, 2.2.3, 2.2.4 release version (not beta)
   TinyMUSH 2.2.4U1 release version (not beta)

Upgrading An Existing TinyMUX:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 - @shutdown the game. Make a flatfile of your DB and move it to a safe 
   location.
 
 - Compile MUX 2.0 per INSTALL.  Note that MUX 2.0 untars into a 
   seperate directory.
 
 - Copy the flatfile to game/data in the MUX 2.0 directory and use 
   db_load to convert the database to binary.
 
 - Copy .txt files to text/ 
 
 - Copy existing mux.config
 
 - **Important** Your old GAMENAME.conf file will not work under MUX 2.0.
   To make a proper file, you must edit the GAMENAME.conf in the MUX 2.0 
   game/ and add in the config parameters.
   - You can save a little time by 'cat oldfile >> newfile' and using 
     the editor to remove unneeded lines.
 
 - Copy any existing comsys.db and mail.db files to game/data.  If your 
   game comes up and the mail and/or comsys are not working, make sure 
   that you put the files in the right directory and restart the MUX.
 
 - Restart the game.


Converting From TinyMUSH 2.0 and TinyMUSH 2.2 to MUX 2.0:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

MUX 2.0 is capable of doing straight conversions of listed TinyMUSH 
versions.  No outside conversion scripts are needed.

 - @shutdown the game and make a flatfile.
 
 - Compile MUX 2.0 per INSTALL.  Note that MUX 2.0 untars into a 
   seperate directory.
 
 - Copy the flatfile to game/data in the MUX 2.0 directory and use 
   db_load to convert the database to binary.
 
 - Copy .txt files to text/ 
 
 - Copy existing mush.config information into mux.config and put this 
   into game/.
 
 - Copy GAMENAME.conf to game/
        - Be sure to make any pertinent changes to configuration options.  
          They are different between TinyMUSH and TinyMUX.  wizhelp.txt 
          should become a close personal friend while you learn them.
 
 - Restart the game.

Changes to dbconvert:
~~~~~~~~~~~~~~~~~~~~
 - One of the major and important changes to MUX 2.0 is the use of CHash 
   in the place of GDBM.  You will notice the changes primarily in the way 
   dbconvert and the db_unload and db_load scripts work.  
 
 - dbconvert is the means by which the binary game data is converted to 
   flatfile format and back again.  The db_load and db_unload scripts 
   simplify the process for the user. 
 
 - The syntax of the scripts is:
   
   - './db_load netmux netmux.flat netmux.db'
     
     This converts flatfiled database to binary for use by the server and 
     would be done with dbconvert thus:
     
     ../bin/dbconvert netmux X < netmux.flat > netmux.db
   
   - './db_unload netmux netmux.db.new netmux.flat'
     
     This converts binary data to flatfile for would be done with dbconvert 
     thus:
     
     ../bin/dbconvert netmux x < netmux.db.new > netmux.flat