================
ROTT Port README
================

This is a port of Apogee's 3D action title Rise of the Triad, originally
released in 1994.  This port duplicates the functionality of the original
game on modern operating systems, including Linux, Win32, and Mac OS X.

This port makes use of the Simple Direct Media Layer, or SDL, and an additional
library named SDL_mixer.  If you do not have these libraries installed, check
the links section below.

This software is distributed in source code format and is licensed under the
terms of the GNU General Public License.  A copy of this license is included
with the software in the file COPYING.

This software is not supported by 3D Realms, Apogee, or the porters.

For reference, the primary contributors to this port are:

Steven Fuller
Ryan C. Gordon
John Hall
Dan Olson


-------------------------
Notes for the 1.1 Release
-------------------------

Thanks to the effort of the contributors listed below (and probably many more),
lots of bug fixes, portability improvements and new features have found their
way into the 1.1 release. Many changes have been ported over from the WinRott
port (not WinRottGL but plain WinRott) with the high resolution software
rendering support being the main feature of all these changes. Portability
fixes include support for 64-bit and big-endian systems.

Birger N. Andreasen (author of the WinRott port
  <http://home14.inet.tele.dk/Bna-Info/>, initial work by Jonathan Bailey)
Hans de Goede (porting of the WinRott high resolution renderer,
  lots of bug and portability fixes for the Fedora package)
Alexander Thomas aka Dr. Lex (author of the OS X port
  <http://www.dr-lex.be/software/rott.html>, thanks Filippo Giunchedi for
  creating the appropriate patch for the Debian package)
Michael Karcher (lots of bug and portability fixes for the Debian package)
Fabian Greffrath (some minor improvements)


----------------------------
Notes for the 1.1.x Releases
----------------------------

Version 1.1.1 is merely a bugfix release that contains all the patches that
have accumulated in Fedora and Debian during the previous year.

Version 1.1.2 is another bugfix release that contains the Debian patches from
the previous two and a half years; among them enabling the playback of demo
files. Furthermore the build system has undergone a complete overhaul.

Enabling the use of UNICODE (instead of keyboard scancodes) for the cheat codes
and names in the highscore table is considered the release goal for the next
point release. Getting network play working is considered the release goal for
the 2.0 version. Work on both of these projects has not yet begun, though...

In this context: Please send bug reports, questions, suggestions and comments
to the Fedora or Debian maintainers of the respective rott packages in these
distributions. Patches are always welcome. ;-)


-------------
General Hints
-------------

The following prerequisites are required to compile the source code:

  autoconf
  automake
  pkg-config
  SDL 1.2
  SDL_mixer 1.2

To compile the source code, type the following:

  autoreconf -fiv
  ./configure
  make

The resulting binaries can be found in the rott/ directory.

The build system is setup to build the commercial variant of ROTT.
This variant supports the Registered Version, the "Super ROTT" CD Version and
the "Site License" CD Version of the game by automatically detecting and
loading their corresponding multiplayer map files.

If you want to build the shareware version of ROTT, configure with:

  ./configure --enable-shareware

Additionally, you may pass the "--enable-suffix=<suffix>" parameter to
./configure in order to append a suffix to the executable file name,
e.g. to tell the commercial and the shareware variants apart. You may
also want to pass the "--enable-datadir=<datadir>" parameter to point
the executables to the location of your game data files.


------------
Known Issues
------------

- Demos go out of sync.
- No netplay support.


-------------
Helpful Links
-------------

ROTT Port site:
http://icculus.org/rott/

The Simple Direct Media Layer:
http://www.libsdl.org/

SDL_mixer:
http://www.libsdl.org/projects/SDL_mixer

3D Realms official forum on ROTT source code:
http://forums.3drealms.com/ubb/ultimatebb.php?ubb=forum;f=24