S E A R C H   A N D   R E S C U E

           I N S T A L L A T I O N   I N S T R U C T I O N S


------------------------
STEP 0: Before you Begin
------------------------

	Before you try to build and install Search and Rescue, you'll
	need to have some other packages installed first. What follows
	are a list of libraries and their package names on Debian (and
	Debian related) distributions.

	Name       -- Package name
	X11        -- libx11-6
	X11 SM     -- libsm-dev
        X11 i      -- libx1-dev
	X11 XMU    -- libxmu-dev
	SDL        -- libsdl1.2-dev (optional for sound)
	SDL Mixer  -- libsdl-mixer1.2-dev (option for sound)
	OpenGL     -- libglu1-mesa-glx libglu1-mesa-dev
	X11 ICE    -- libice6
	X11 Pixmap -- libXpm-dev

	If you find additional dependencies which are not included in your
	distribution, please report them so we can add them to the list.


------------------------
STEP 1: Configure Source
------------------------

	Configure the source for your system, type:

	# ./configure --listall

	This will run the compiler test and print all available
	platforms. Choose the most appropriate platform and
	add any additional arguments as needed (see ./configure --help
	for more information on enabling/disabling and overriding
	source configuration values).

	To select your platform simply type the platform name and
	any additional arguments to the ./configure line, example:

	# ./configure Linux --prefix=/usr -v 

------------------------ 
STEP 2: Building Program
------------------------ 

	If there were no problems configuring the source for your
	system, then just type:

	# make all

	This will start the compiling process.

	If you encountered errors, then you should report them to the
	authors. Read the AUTHORS file for a list of addresses.


--------------------
STEP 3: INSTALLATION
--------------------

	To install, su to root as needed and type:

	# make install

	Note: If you specified an alternate prefix in the ./configure
	line then the installation location may be different than shown
	below.

	Data files are installed in:

		/usr/share/icons/SearchAndRescue.xpm
		/usr/share/icons/SearchAndRescue2.xpm
		/usr/share/icons/SearchAndRescue3.xpm

		/usr/man/man6/SearchAndRescue.6.bz2

		$HOME/.SearchAndRescue/

	Program is installed in:

		/usr/games/SearchAndRescue


	Next, you need to install the latest SearchAndRescue data files
	in to the directory.

		/usr/share/games/searchandrescue/

	You can obtain the latest data files at the same place where you
	obtained this source.  Once you have obtained the data files
	package, su to root as needed and type:

	# mkdir -p /usr/share/games/searchandrescue/
	# cd /usr/share/games/searchandrescue/
	# tar -zxvf /home/me/SearchAndRescue-data-1.3.0.tar.gz

	Alternitively, if you have the SearchAndRescue-data-1.3.0.tar.gz
	file in the top-level source code directory, you can run

	# installsardata

	This will attempt to unpack the Data file to the proper
	location.



---------------
STEP 4: RUNNING
---------------

	To run this program type:

	# SearchAndRescue &

        For additional command line options, type:

        # SearchAndRescue --help

	Or for more detailed help, read the manual page:

	# man SearchAndRescue


	(Linux only) If you want joystick support then make sure that
	you have compiled joystick support and that your joystick
	driver modules are loaded, to find out type:

	# lsmod | grep joy

	To load modules type `modprobe <driver>', example:

	# modprobe joy-analog

	Many joysticks have more axises and buttons than what the
	joystick driver detects on default. Read the documentation
	that came with the joystick driver (usually from the Linux
	kernel source /usr/src/linux/Documentation/joystick.txt).

	Example if you have Saitek Cyborg 3D joystick:

	# modprobe joy-analog js_an=0x201,1023,0


                                                         -----------------
                                                         SEARCH AND RESCUE