From f00575079e186bad1bbd6f4768027747db5ba748 Mon Sep 17 00:00:00 2001 From: Simon Howard Date: Sun, 30 May 2010 02:56:58 +0000 Subject: Clarify/update install instructions. Subversion-branch: /trunk/chocolate-doom Subversion-revision: 1936 --- INSTALL | 159 ++++++++++++++++++++++++++++++++++++++-------------------------- 1 file changed, 94 insertions(+), 65 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 80df9361..7ad85b7f 100644 --- a/INSTALL +++ b/INSTALL @@ -2,13 +2,18 @@ Chocolate Doom installation =========================== -These are instructions for how to install Chocolate Doom on Unix-like -Operating Systems. +These are instructions for how to install and set up Chocolate Doom +for play. -Dependencies ------------- +Building Chocolate Doom +----------------------- -Chocolate Doom requires the following to be installed: +Before you can play Chocolate Doom, you need to compile a binary that +you can run. If you are using Windows or Mac OS X, precompiled +binaries are available on the website for download, and you can skip +this section. + +For compilation, Chocolate Doom requires the following to be installed: * A C compiler (gcc is recommended) * make (GNU make is recommended) @@ -17,84 +22,108 @@ Chocolate Doom requires the following to be installed: * SDL_net (see http://www.libsdl.org/projects/SDL_net/) * Python (optional) -Building Chocolate Doom ------------------------ - -On a Unix system, follow the standard instructions for installing an -autotools-based package: +Follow the standard instructions for installing an autotools-based +package: 1. Run './configure' to initialize the package. 2. Run 'make' to compile the package. 3. Run 'make install' to install the package. -Advanced topics such as cross-compilation are beyond the scope of this +Advanced topics such as cross-compilation are beyond the scope of this document. Please see the GNU autoconf / automake documentation for more information. -Installing an IWAD file ------------------------ +Obtaining an IWAD file +---------------------- -To play Doom, an IWAD file is needed. This contains the Doom game data. The -file usually has one of the following filenames: +To play Doom, you need an IWAD file. This file contains the game data +that is used in gameplay (graphics, sounds, etc). The full versions of +the Doom games are proprietary and need to be bought. The IWAD file +has one of the following names: doom1.wad (Shareware Doom) doom.wad (Registered / Ultimate Doom) doom2.wad (Doom 2) tnt.wad (Final Doom: TNT: Evilution) plutonia.wad (Final Doom: Plutonia Experiment) + chex.wad (Chex Quest) -When you have this file (see the next section, "Obtaining an IWAD file", for -how to get this file), install it through one of the following methods: +If you don't have a copy of the commercial version, you can download +the shareware version (extract the file named doom1.wad): - * Put the file into the /usr/share/games/doom or - /usr/local/share/games/doom directories. - * Install it into a directory and set the environment variable DOOMWADDIR to - be the path to that directory. - * Install multiple IWADs into separate directories and set the environment - variable DOOMWADPATH to be a colon-separated list of directories to search - (similar to the Unix PATH environment variable). - * Run Chocolate Doom with the '-iwad' command line parameter to specify the - IWAD file to use, eg. + * http://www.doomworld.com/idgames/index.php?id=7053 + (idstuff/doom/win95/doom95.zip in your nearest /idgames mirror) - chocolate-doom -iwad /root/doom2.wad +If you have a commercial version, obtaining the IWAD file may slightly +complicated. The method depends on how you obtained your copy of the +game: -Obtaining an IWAD file ----------------------- + * There have been several CD-based versions of Doom. Generally, the + IWAD files can be found on the CD and copied off directly. -Obtaining the IWAD file may be a complicated process under Unix. The method -depends on how you obtained your copy of the game: + * The IWAD files might not be directly available on the CD. Look for + a program named "deice.exe". In the same directory, there should + be a single large file with a numbered extension (eg. + "resource.1"); to extract this, follow the same instructions as for + the floppy disk version (see below). - * There have been several CD-based versions of Doom. Generally, the IWAD - files can be found on the CD and copied off directly. + * If you have the floppy disk version of Doom, first copy the + contents of all the floppy disks into a directory together. You + will have several large files with numbered extensions. + Concatenate these into a single file, eg. - * The IWAD files may not be directly available on the CD. Look for a program - named "deice.exe". In the same directory, there should be a single large - file with a numbered extension (eg. "resource.1"); to extract this, follow - the same instructions as for the floppy disk version (see below). + (Unix instructions) + cat doom_se.1 doom_se.2 doom_se.3 doom_se.4 doom_se.5 > doom_se.exe - * If you have the floppy disk version of Doom, first copy the contents of all - the floppy disks into a directory together. You will have several large - files with numbered extensions. Concatenate these into a single file, eg. + (Windows/DOS instructions) + copy doom_se.1+doom_se.2+doom_se.3+doom_se.4+doom_se+5 doom_se.exe - cat doom_se.1 doom_se.2 doom_se.3 doom_se.4 doom_se.5 > doom_se.exe - - The resulting file is self-extracting LHA file. If you have a DOS emulator - (such as DOSbox), you can run it to extract the files; alternatively, you - can use the Unix LHA tool to extract the archive. + The resulting file is self-extracting LHA file. If you have a DOS + emulator (such as DOSbox), you can run it to extract the files; + alternatively, you can use the Unix LHA tool to extract the + archive. * The Doom games are also available for download on Steam - (http://www.steampowered.com/). To find the IWAD files, look in your Steam - directory, under the "steamapps/common" path. + (http://www.steampowered.com/). To find the IWAD files, look in + your Steam directory, under the "steamapps/common" path. + +Running the game +---------------- + +When you have an IWAD file, install it through one of the following +methods: + + * Under Mac OS X, you can specify the locations of the IWAD files + through the graphical launcher program. Click the "Configure..." + button, and then click "Set..." for each IWAD location to choose + its location. + + * Under Unix, put the file into the /usr/share/games/doom or + /usr/local/share/games/doom directories. + + * Place it in a directory and set the environment variable DOOMWADDIR + to be the path to that directory. + + * Install multiple IWADs into separate directories and set the + environment variable DOOMWADPATH to be a colon-separated list of + directories to search (similar to the Unix PATH environment + variable). + + * Run Chocolate Doom with the '-iwad' command line parameter to + specify the IWAD file to use, eg. + + chocolate-doom -iwad /root/doom2.wad Playing with Chex Quest ----------------------- -Chex Quest is a game based on Doom with some minor modifications that was -distributed with boxes of Chex cereal in 1997. It is possible to play -Chex Quest using Chocolate Doom. To do this, the following files are -needed: +Chex Quest is a game based on Doom with some minor modifications that +was distributed with boxes of Chex cereal in 1997. It is possible to +play Chex Quest using Chocolate Doom. To do this, the following files +are needed: * The IWAD file 'chex.wad', from the Chex Quest CD. + * The dehacked patch 'chex.deh', which can be found in the /idgames repository in utils/exe_edit/patches/chexdeh.zip. @@ -106,30 +135,30 @@ line parameter to specify the Chex Quest IWAD file: Installing upgrades ------------------- -Chocolate Doom requires a Doom 1.9 IWAD file. Generally, if you install a -recent version of Doom you should automatically have a 1.9 IWAD. However, if -you are installing from a very old CD version or from floppy disks, you might -find you have an older version. +Chocolate Doom requires a Doom 1.9 IWAD file. Generally, if you +install a recent version of Doom you should automatically have a 1.9 +IWAD. However, if you are installing from a very old CD version or +from floppy disks, you might find you have an older version. -The most obvious symptom of an out of date IWAD file is that the game will -exit at the title screen before the demo starts, with the message "Demo is -from a different game version!". If this happens, your IWAD file is out of -date and you need to upgrade. +The most obvious symptom of an out of date IWAD file is that the game +will exit at the title screen before the demo starts, with the message +"Demo is from a different game version!". If this happens, your IWAD +file is out of date and you need to upgrade. -Id Software released upgrade patches that will update your game to 1.9. The -following sites have the patches: +Id Software released upgrade patches that will update your game to +1.9. The following sites have the patches: - http://www.doomworld.com/files/patches.shtml + http://www.doomworld.com/files/patches.shtml http://www.doom2.net/doom2/utils.html ftp://ftp.idsoftware.com/idstuff/doom2 -As the patches are binary patches that run as DOS executables, you will -need a DOS emulator (such as DOSBox) to install them. +As the patches are binary patches that run as DOS executables, you +will need a DOS emulator (such as DOSBox) to install them. Music support ------------- -Support for Doom's MIDI music is available through timidity: +Support for Doom's MIDI music is available through Timidity: http://timidity.sourceforge.net/ -- cgit v1.2.3