Heretic II 1.06b
                              Full Install
                              May 2, 2001


This install requires that you have the Linux Heretic II CD mounted.


Enhancements in the 1.06b update include:
 * Updated internal libraries, including SDL 1.2.0
 * Fix deadlock in software mode with XFree86 4.0
 * Default to using the system OpenGL library
 * Added --windowed and --fullscreen command line options
 * Improved movie playback performance
 * Fixed several trigger crashes from loaded save games
 * Fixed music playback on some SCSI CD-ROM drives
 * Updated to work with the Loki Update Tool

Enhancements in the 1.06a update include:
 * Fully rewritten video and input subsystem, utilizing SDL 1.1.1
 * Optimized MMX assembly for the software renderer
 * Completely reorganized internal linking architecture
 * Many crash fixes
 * Joystick support
.. and many more improvements.


RUNNING THE GAME
================

To start the game, run the "heretic2" binary in the installation directory.

A few tips:

If you want to run in software mode, start the game with the options:
	+set vid_ref soft

If you want to run in hardware mode, start the game with the options:
	+set vid_ref glx

You can specify a GL driver to be loaded by adding the following options:
	+set gl_driver /usr/lib/libGL.so.1
where "/usr/lib/libGL.so.1" is the full path of the GL driver you want.

Note: Mesa 3.0 does not work correctly with Heretic II and Voodoo cards.


PATCH DETAILS
=============

1. Save Games
   All known save game related crashes are fixed.
   WARNING: Save games are not compatible with the original game.

2. Software Renderer
   The software renderer has been fully optimized with x86 and MMX
   assembly.  The MMX instructions are enabled by default if your
   processor supports them.  You can disable MMX optimization by
   adding "+set cpu_mmx 0" to the Heretic II command line.

3. OpenGL Renderer
   Heretic II ships with support for 3Dfx cards, and other cards
   may be supported.  For details go to http://www.lokigames.com/

4. Fullscreen Mode
   The game is configured to prevent you from losing keyboard focus,
   by locking you into fullscreen mode.  You can switch to windowed
   mode by running the game with "+set always_grab 0" and then changing
   the fullscreen option in the video settings menu.
   WARNING: Do not do this when using the Voodoo card in pass-thru mode.

5. New Key Bindings
   If you disable the focus protection as described above, you can use
   some new key bindings:

     ALT-Enter : Toggle fullscreen mode on or off.
     CTRL-g    : Toggle binding the mouse in the window.

6. Joystick Support
   In order to use the new joystick support, you must have the joystick
   driver configured and calibrated in your kernel.  The joystick driver
   is included with Linux 2.2, and also available from:
	http://atrey.karlin.mff.cuni.cz/~vojtech/joystick/
   To enable joystick support in Heretic II, go to the "More Options"
   menu and change the joystick option to yes.  If the option reverts
   to "no" when you go back to the menu, Heretic II was unable to find
   the joystick; verify that the joystick module is working properly.

   The patch installs a default joystick configuration that maps the
   joystick x and y axes to left/right rotate and move forward/backward
   respectively.  You can change the axis mapping like this:

   Joystick X axis variable: joy_advaxisx
   Joystick Y axis variable: joy_advaxisy
   Joystick Z axis variable: joy_advaxisz
   Joystick axis 3 variable: joy_advaxisr
   Joystick axis 4 variable: joy_advaxisu
   Joystick axis 5 variable: joy_advaxisv

   Available axis actions:
   No action:              0
   Move forward and back:  1
   Look left and right:    2
   Strafe side to side:    3
   Turn left or right:     4
   Jump up or crouch down: 5

   So, to map the X axis to strafe right and left, you would add the
   following line to your config.cfg file in ~/.loki/heretic2:
	set joy_advaxisx 3

   You can map the buttons and hat positions normally in the control
   configuration menu.

   Joysticks with built-in trackballs (like the MadCatz Panther XL)
   map the trackball as though it were a mouse device.  You can change
   the sensitivity by modifying the "joy_ballsensitivity" variable.
   The default value for this parameter is 0.03.

7. Mouse-wheel Support
   If you have a mouse with a wheel, you can now use it in Heretic II.
   First map your mouse wheel in X11 to buttons 4 and 5 as described:
	http://www.inria.fr/koala/colas/mouse-wheel-scroll/
   Now, edit the config.cfg file in the ~/.loki/heretic2 directory and
   bind the mouse wheel movements to the actions you want to perform.

   For example, you can bind the wheel to switch weapons:
	bind MWheelUp   "weapnext"
	bind MWheelDown "weapprev"

8. Multi-player Fixes
   Maps and skins are now saved to the user's directory: ~/.loki/heretic2
   Maps and skins are now loaded case-insensitively.

9. Server Timeout
   The server timeout has been extended so the server shouldn't stop
   when loading a particularly large level on slower machines.


CONTACTING LOKI SOFTWARE, INC.
==============================

For information about this and other products, visit our website at:
http://www.lokigames.com/

Technical support is available from Loki Software, Inc. at:

    FAQ:      http://faqs.lokigames.com/
    Website:  http://fenris.lokigames.com/
    Email:    support@lokigames.com

You can also communicate with other Heretic II enthusiasts at:
Usenet: news://news.lokigames.com/loki.games.heretic2