QUICKSTART for ldescent v0.0.20 - Descent for i386/Alpha Linux/FreeBSD

0. Contents
-----------
   1. Introduction
   2. Requirements
   3. Building
   4. Running

1. Introduction
---------------

   ldescent is a Linux/FreeBSD i386/Alpha port of the Descent 1 source 
   released by Parallax Software.

   This modified version of DESCENT is NOT supported by Parallax or
   Interplay, in fact it's not supported at all.
   USE AT YOUR OWN RISK!

   Descent Copyright (c) 1994 Parallax Software Corporation
   Descent is a trademark of Interplay Productions, Inc.

2. Requirements
---------------

   To run ldescent you need the datafiles of Descent 1 Registered v1.4 or
   higher. If you only have Descent 1 v1.0 you can get a free upgrade from
   most Descent sites (e.g. http://www.descent2.com/patches). Don't get the
   v1.0 -> v1.5 upgrade, since it removes the music from level 8 and higher.

   To build ldescent you need the GNU C development tools (gcc, binutils,
   make), and some other common programs (Bourne shell, sed, grep, etc.). 
   Futher you need the X libraries or the SVGALib library.

   To run ldescent you need the datafiles of Descent 1 Registered v1.4 or
   higher. If you only have Descent 1 v1.0 you can get a free upgrade from
   most Descent sites (e.g. http://www.descent2.com/patches). Don't get the
   v1.0 -> v1.5 upgrade, since it removes the music from level 8 and higher.
   
   ldescent runs on i386 and Alpha Linux, and FreeBSD under X or SVGALib.
   ldescent under SVGALib needs root privileges.

3. Building
-----------

   If you want to use SVGALib start `configure --with-svga' otherwise start
   `configure'. You can add other options, see `configure --help' for an
   overview (see BUGS for possible problems with these options, especially
   the sound support has some shortcomings).
   Now run `make' (the warnings are normal). If there are no problems,
   the executable `ldescent' will be created in the `main' subdirectory.

4. Running
----------

   Put the Descent v1.4+ datafiles descent.hog and descent.pig in the
   current directory and run `ldescent'.
   Note that a DISPLAY variabele is required for X support.

   See the FAQ for how to use Kali with ldescent.
   

   Enjoy!

Arne de Bruijn
arne@knoware.nl