X-Git-Url: https://git.artsoft.org/?p=rocksndiamonds.git;a=blobdiff_plain;f=INSTALL;h=697475a70f88f74f9bb6ff9efa16a8cd5b3d28f2;hp=298ff6d6186085177ce0c227c5737eb52e35be0d;hb=629ac5b85f0d60b24828590de3430c52f42607dc;hpb=3dc317d10b44cc6b75db10ac194966ad8114d390 diff --git a/INSTALL b/INSTALL index 298ff6d6..697475a7 100644 --- a/INSTALL +++ b/INSTALL @@ -1,68 +1,85 @@ -WHAT TO DO TO INSTALL "ROCKS_N_DIAMONDS-0.9" ON YOUR SYSTEM -=========================================================== - -If you have a Linux system (Intel based, a.out, kernel 1.2.x), you -can use the precompiled binary. - -If you have another Unix system, or an ELF system or just want to -compile the program by yourself, do the following: - -Edit the file "Makefile" and set the following options: - -XPM_INCLUDE_FILE - change this to the location where you - have your XPM-Library include file. - - You must have the XPM-Library "libXpm" - installed on your system to run this game. - If you don't have it, look at your local - FTP site with X11 archive to get it! :) - -GAME_DIR - You can leave these values untouched - if you use the default location for - the game directory. - If you want to move it to other places in - your directory tree, just change them - accordingly. (You can use symlinks instead, - of course.) - You might want to set GAME_DIR to the full - path of the game in your file system, so - you don't have to go to the game directory - when you want to play it. - -SOUNDS - If you never want to hear any sounds, - set this to "-DNO_SOUNDS", but be warned: - It's much less fun playing without sound! :) - (The program detects by itself if it can - play sounds or not, anyway.) - -SCORE_ENTRIES - Set this to "-DONE_PER_NAME" if you want - to allow only one entry per player in the - score file for each level. This is useful - if there are many players to prevent one - single player to "flood" the Hall Of Fame - of every level completely with his name... - On single user systems, "-DMANY_PER_NAME" - might be useful to have your name more - than once in the list. - -SYSTEM - If you have problems with the default - settings, it might be useful to uncomment - one of the defines for "SYSTEM" in the - Makefile, which defines values like - "-DSYSV" and something like that. - -CC, INCL, LIBS - Set these ones to the appropriate values - you usually use on your system to compile. - - -Now you can 'make clean' and 'make' and the game binary should be -compiled right out of the box. I have tested it with "-Wall" on my -system, so I hope that it compiles fine on other systems, too. - -The program should compile and run on Linux (of course), -HP-UX, AIX, Net-BSD, SUN and IRIX. - -Have fun! - -Holger Schemel, 22. Oktober 1995 +Installation instructions for Rocks'n'Diamonds 1.2.0 +==================================================== + +Compilation +----------- + +If your system supports Linux/i386/ELF/libc5 executables (Linux package) +or if you run DOS/Windows (DOS package), you can directly use the included +precompiled binary. + +If you use a different system, just recompile the game: + +If you use Linux with gcc or DOS/Windows with djgpp, just try 'make' +which should work without problems. + +If you use SUN/Solaris with gcc and GNU make, try 'make solaris'. + +If the above doesn't work, edit the Makefile in the top level directory. +If it doesn't work either, edit the Makefile in the 'src' subdirectory. + +If you had to modify any Makefile to compile it, please drop me a note +about it to 'aeglos@valinor.owl.de'. Thanks! + + +Customization +------------- + +The following configuration options in the top level Makefile help +you to customize the game to your system and your environment: + +CC Choose your favorite ANSI C compiler. + Default is 'gcc'. + +PLATFORM Choose your platform, if auto detection fails. + Auto detection should work for Linux and DOS + (just type 'make'), on SUN/Solaris systems 'make solaris' + should work. Other systems may need additional editing + of 'src/Makefile' to set some additional compiler options. + +X11_PATH Specify the path to your X11 installation. Include files + and libraries are searched for at $(X11_PATH)/include and + $(X11_PATH)/lib, if you set this variables. If you don't + set this variable, your compiler must be able to find X11 + by itself, which works fine for Linux, for example. + +GAME_DIR Specify the directory where the program looks for all the + graphics, sounds, levels and high scores. If you leave this + commented out, the current directory ('.') is used, which + lets you use the game without installing it somewhere in + your system (although you have to 'cd' to the game directory + each time you want to play it). + +JOYSTICK Uncomment this line if your system does not support game + port hardware like joysticks (and has therefore no joystick + include file). Currently the game should work with joysticks + on Linux and FreeBSD. + +SOUNDS Uncomment this line if your system does not support audio + hardware. Currently the game should work with sound support + on Linux, FreeBSD, SUN/Solaris, HP-UX and most Unix system + that support '/dev/dsp' or '/dev/audio' devices. + +SCORE_ENTRIES Choose if you want to allow many entries in the high score + table for one player or exactly one entry. Systems with a + lot of users maybe want to limit high score entries to only + one entry for each player (and therefore set 'SCORE_ENTRIES' + to 'ONE_PER_NAME') where systems used by only one person + maybe want to use the default of 'MANY_PER_NAME' which is + automatically choosen if you leave everything commented out. + +Modifications of the Makefile in the directory 'src' are normally not needed. +If the game fails to compile out of the box, you may have to modify some +of the system variables there to get it to compile. + +SYSTEM May need to be set to some system dependend values. + +INCL, LIBS Maybe some more directories for include files and libraries + have to be added to this variables depending on your system. + + +If you have any comments, additions or modifications to the Makefile(s), +please send me mail: 'aeglos@valinor.owl.de'. Thanks! + +05-DEC-1998, Holger Schemel