ref: f00575079e186bad1bbd6f4768027747db5ba748
parent: 39494b5a451472db3b613446a5b1c8c2b0d92cf6
author: Simon Howard <[email protected]>
date: Sat May 29 22:56:58 EDT 2010
Clarify/update install instructions. Subversion-branch: /trunk/chocolate-doom Subversion-revision: 1936
--- a/INSTALL
+++ b/INSTALL
@@ -2,14 +2,19 @@
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)
* LibSDL (see http://www.libsdl.org/)
@@ -17,25 +22,24 @@
* SDL_net (see http://www.libsdl.org/projects/SDL_net/)
* Python (optional)
-Building Chocolate Doom
------------------------
+Follow the standard instructions for installing an autotools-based
+package:
-On a Unix system, 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)
@@ -42,59 +46,84 @@
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 @@
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/