_ _                             _____ 
  __| | |__   _____      ___ __ ___ |___ / 
 / _` | '_ \ / _ \ \ /\ / / '_ ` _ \  |_ \ 
| (_| | | | |  __/\ V  V /| | | | | |___) |
 \__,_|_| |_|\___| \_/\_/ |_| |_| |_|____/ 

** Doom 3 GPL source modification

Use this if you want to run the dhewm3 modification of the Doom 3 engine
source code release on the latest Fedora and RHEL/CentOS distributions.

For the additional features and fixes introduced by this great modification,
please see the original page at:
 https://github.com/dhewm/dhewm3

======== Package information

This package tries to comply as maximum to the Fedora Packaging Guidelines; 
this means the game has debuginfo packages, default Fedora's GCC compile time
options and standard locations for binaries, data and docs.

======== Game data

It DOES NOT include game data required to run the game, you have to get the data
yourself buying the game.

A sample nosrc rpm that can be used to build a binary rpm using the CD data
files is at: http://slaanesh.fedorapeople.org/

To rebuild it, add the required files to your SOURCES directory and remove the
"NoSource" lines in the spec file.

A high resolution icon has been generated from the game assets, to have a look
at how the resulting menu entries look like see:
http://slaanesh.fedorapeople.org/doom3-menus.png

You should end up with something like this:

 $ rpm -qa dhewm3* doom3*
 dhewm3-1.3.1.1304-12.git.1b1787bb.fc17.x86_64
 doom3-roe-1.3.1.1304-4.fc17.noarch
 doom3-1.3.1.1304-4.fc17.noarch

======== Options defined at compile time

- Uses unbundled Fedora libraries for the following components:
	OpenAL
	Curl
	Ogg Vorbis
	SDL
	zlib
- No CD key asked for the games, as network compatibility with official servers
  has already been broken:
  https://github.com/dhewm/dhewm3/commit/20aaba2c651ebb8c22db08f1a9ea0695c37d0732
- Provides a doom3-engine symlink through the alternatives system to easily
  switch between additional variations (like https://github.com/omcfadde/dante).
- Enables EAX by default, since the engine now uses OpenAL (s_useEAXReverb=1).
- Removes engine cap to more than 60 fps without speeding up engine (com_fixedTic=-1).
- Enables the Z-Fail method (Carmack's reverse).
- Supported distributions:
	RHEL/CentOS 6	i686/x86_64/ppc64
	Fedora 17	i686/x86_64
	Fedora 18	i686/x86_64
	Fedora 19	i686/x86_64

======== Notes

- On RHEL/CentOS 6 the EPEL repository is needed.
- RHEL/CentOS 6 ppc64 builds are untested.
- Upon first start, it sets the resolution automatically for setups that use a
  single monitor, otherwise it falls back to 640x480 like the original game.
- The game menu is ALWAYS at 640x480 by game design.

To install the repository, run as root the following commands.

For RHEL/Centos:

wget http://repos.fedorapeople.org/repos/slaanesh/dhewm3/epel-dhewm3.repo \
	-O /etc/yum.repos.d/epel-dhewm3.repo

For Fedora:

wget http://repos.fedorapeople.org/repos/slaanesh/dhewm3/fedora-dhewm3.repo \
        -O /etc/yum.repos.d/fedora-dhewm3.repo

======== Bugs

Please DO NOT file bugs in Fedora and DO NOT file bugs in the original github
page hosting the source code.

The address for contacting me is in the package's changelog.