Compilation and Installation
In order to compile and install KStella on your system from a source tarball, type the following in the base directory of the KStella distribution:
% ./configure % make % make install (as root)
Since KStella uses autoconf and automake you should have not trouble compiling it. Should you run into problems please report them to Stephen Anthony at <firstname.lastname@example.org>.
KStella now comes in a source RPM (SRPM) package as well. To compile and install this SRPM, consult your distributions instructions regarding compiling and installing SRPM's.
Once KStella is built and installed, you need to do a few other things:
You will need a stella.pro file:
If the Stella RPM was previously installed, you will already have it (in '/etc/stella.pro') and can proceed to the next step.
Otherwise, download the file 'stella.zip' to your home directory. Decompress this file with the command "unzip stella.zip". You should now have a file called 'stella.pro'. You can either place this file in /etc as '/etc/stella.pro' or in your home directory as '$HOME/.stella/stella.pro'. If you place it in both locations, then the one in your HOME directory will be used.
Create a directory to hold your roms. The location of this directory is your choice.
Copy any game roms you acquire to your 'roms' directory.
Thats all you need for basic KStella usage. See the next section if you want to add snapshots, manuals, etc.
You may download optional manuals, game snapshots and cartridge labels. These are all located at the KStella page. You only have to install the ones you want, they are all optional. The following gives a description of how to do this:
Download the latest versions of the manual, snapshot, and label RPM's from the KStella page. These files will be named as kstella-PACKAGE-DATE-1.noarch.rpm. For example, the labels from Aug 10, 2002 would be in a file named "kstella-labels-20020810-1.noarch.rpm".
The procedure for installing these files is simple. Use the command 'rpm -Uvh FILENAME.rpm', or click on the RPM file from a Konqueror window (consult your specific distribution).
One point to be careful of. If you wish to save snapshots from KStella to the snapshots directory, you will have to make sure that you have write access to this directory. The command to do this is 'chmod -R +w /usr/share/kstella-snapshots' (as root).
That's it, KStella should be correctly installed :) See the next section on how to actually configure and use KStella.