README

0. License

Race Into Space is distributed under GNU General Public License (GPL) version 2. You can find the terms and conditions in file COPYING.

1. Running the game

If you have downloaded the source distribution then see DEVELOPER file. Follow on once you have the game executables ready.

Try to run the game, it will probably complain about missing data files. This should not happen if you have downloaded and properly installed one of binary distributions (ie. RPM or windows installer). If you have built the game from source then get the data files from http://sf.net/projects/raceintospace/

Once you have your data files extracted, edit the file ~/.raceintospace/config - it will be created when you start the game for the first time. Hopefully the file format is self-explanatory. By the way, your saved games will be stored in the same directory (~/.raceintospace)

Alternatively you can specify location of configuration directory and game data directory with environment variables BARIS_SAVE and BARIS_DATA, respectively. These are also supported when present on the command line, ie:

$ raceintospace BARIS_DATA=$HOME/baris BARIS_SAVE=$HOME/baris/saves

Good luck on your way to the Moon!

1a. Running on Microsoft Windows platforms.

On Windows error messages will go to the stderr.txt file created in the working directory (usually the directory where the main executable resides). Whenever the game crashes or misbehaves look for clues in that file.

The installer creates shortcuts with location of game data files provided on the command line. Location of save game directory is obtained using environment variables HOME, HOMEPATH and USERPROFILE (in that order). Users reported that on Windows 98 neither of those is set by default. To solve this problem either set one of above variables or edit the game shortcut's command line and provide desired location for save games, ie:

"c:\program files\raceintospace\raceintospace.exe" "BARIS_DATA=c:\program files\raceintospace" "BARIS_SAVE=c:\program files\raceintospace\saves"

2. Troubleshooting

Probably you will run into some bugs, at least if you play the game long enough. To help us improve raceintospace please try to find a way to reproduce it and submit a bug report via the Tracker at http://sf.net/projects/raceintospace/ possibly accompanied by a save game file and your system information (os version, libraries, environment variables, command line arguments, etc.)

3. Development

see file DEVELOPER.

---