BSPUPD96
========

This program converts BSP config files from previous versions to 
version 0.96b. BSP 0.96b uses new file formats and has renamed a 
number of commands and settings which will be .

When the program is ran without agruments, it will start in a GUI 
mode. The GUI mode provides a feature to automate the task of 
converting all config files from a BSP installation directory.

For advanced usage information, type "bspupd96 /?" at a command
prompt.


DIRECTIONS TO UPGRADE CONFIG FILES:
==================================


 1. Run "BSPUPD96.EXE". A dialog window will appear with a console 
    window behind it.

 2. Type in the location of your BSP directory in the first textbox. 
    This will usually be "C:\BSP".

 3. In the second box, type the location of a TEMPORARY directory to 
    copy the converted files to. It is important that this directory
    is empty so it will be easy to copy files from.

 4. Press the "Convert Files" button. Any diagnostic messages will
    be displayed in the console window. After the files have been
    processed, the temp directory will be opened. There should be a
    couple of subdirectories here with config files in them. Check
    them over to make sure everything went Ok.

    If this directory is empty, then:

     - verify the source directory exists and contains .ini files.

     - check the console window for error messages.

 5. Copy all files in this directory, and paste them into the BSP .96 
    directory. When Windows asks if you want to replace files, 
    choose "Yes to all".


TECHNICAL INFO
==============

These are the changes performed by the GUI: 

 - Game.ini files found in subdirectories are converted to Game.cfg
   files.

 - Bspwin.ini is merged into Bsp.ini. 

 - Bsp.ini is still used in .96 for recent files and window positions, 
   but the [BSP] section is no longer used.

 - Bsp.ini is converted into Bsp.cfg

 - Bspmouse.ini and Bspmou3d.ini are renamed to .cfg files.

 - Bspbars.ini, Groupbar.ini, and Keyboard.ini have command names 
   updated and are renamed to .cfg files.


COMMAND LINE OPTIONS
====================

BSPUPD96 /I filename /OUT filename [/C | /S]

Mode:
  /C         Upgrade command names. Occurances of old names are replaced.
  /S         Upgrade Windows .INI format settings file. Old names are
             replaced, and values right of '=' may be converted.
  /W         Merge 'Window Placement' section from one .ini into another.
Options:
  /F         Force overwrite of /OUT file.
  /I file    Input file to process.
  /OUT file  Output file. Must differ from /I param.


Command files have the command names replaced inline, so any formatting
in these files can be preserved.

Settings files have a completely new format, so the files must be rebuilt.
This will lose formatting and comments. The new format for settings is
"key" "value".

The /W option is used to copy the [Window Placement] section from 
bspwin.ini into bsp.ini.

.
