
                       Quake III Arena Point Release
                                  Update  
                               Version 1.17
                            April 28th,  2000 


       TABLE OF CONTENTS

       i What's new

       1 System Requirements
       2 X11 Setup 
       3 Sound Setup
       4 Playing The Game
       5 Known Issues
       6 Contacting id Software
       7 Contacting Loki Entertainment Software


-------------------------------
(i) What's new
-------------------------------

This is a security fix release. It also includes the full set
of pak patch files required to connect to a pure server. See
README.id in your installation directory for details.

The Q3A binaries are now build at Loki, as Loki has taken over the
maintenance of Linux Q3A from Dave Kirsch. If there are any problems 
with this release, please report them to 
   bk@lokigames.com
or use http://fenris.lokigames.com/. Please do not send e-mail to
Dave "Zoid" Kirsch, and if you report Linux specific problems to
id Software, please send us a copy.

Changes since Beta4:
   +  switched to gcc-2.95-2 on glibc-2.0.7-29
      (this fixed e.g. the "red tint" issues with Beta4)

Changes since Beta3:
   +  fixed Z_Free exit

Known issues:
   -  Mods menu does not work yet on Linux
   -  Illegible messages from crowded servers

Please see README.id for the changes that apply to all platforms. See
below for Linux specific issues. See Help/Q3A_FAQ.html for a copy of
the current Q3A FAQ document.

Depending on whether you intend to update the Linux Retail version,
the Linux Q3A Demo version, or use the Win32 or Mac retail version
on a Linux machine, you might have to move some files manually. The 
following files are important:

  quake3.x86             - Linux full binary
  q3ded                  - Linux dedicated server
  libMesaVoodooGL.so.3.2 - Mesa 3.2 for Glide
  baseq3/pak1.pk3        - patch data file
  baseq3/pak2.pk3        - patch data file

These files have to be copied to the directory where the baseq3/pak0.pk3
file is located.  For the Linux retail version, you should be able to
install these files over the original install.


-------------------------------
(1) MINIMUM SYSTEM REQUIREMENTS
-------------------------------

  * Linux kernel version 2.2.9 or above, glibc-2.0 or above
  * XFree86 SVGA server version 3.3.5 or above, running at 16 bpp depth
  * Pentium 233MHz MMX processor with 3dfx 8 MB Video Card
     or Pentium II 266MHz processor with 3dfx 4 MB Video Card
     or AMD 350MHz K6-2 processor with 3dfx 4 MB Video Card
  * 64 MB RAM
  * 4x CD-ROM drive (600 KB/sec sustained transfer rate)
  * OSS compatible sound card
  * Hard disk drive with at least 20MB of disk space,
     and 480MB if you do not want to use the live filesystem from CD

  Multiplayer Requirements
  * Internet and LAN (TCP/IP) play supported
  * Internet play requires a 28.8 Kbps (or faster) modem

A 100% full OpenGL compliant 3-D video card and Linux driver is 
required. Quake III Arena uses the OpenGL API for 3-D hardware 
acceleration. There is no software-only version of the game. If
your computer is not hardware accelerated with a game compatible
graphics card, you will NOT be able to run Q3A. Currently,
only standalone drivers for 3dfx based cards are included with
demo and point release distributions.

For updates on GL drivers, in particular for the Matrox G200/G400,
see http://www.lokigames.com/support/gldrivers/.

Please follow the installation instructions presented there for adding the
correct drivers for your 3D-acceleration card.

NOTE:  Linux Q3A will try to load "libGL.so" before using other drivers,
and it will ignore libraries from the quake3/ directory if executed
with root privilege. This can cause problems if you have a software or 
third party OpenGL driver installed.

You can specifically target e.g. the included 3dfx based Mesa driver,
by using the following command line:

	quake3 +set r_gldriver libMesaVoodooGL.so.3.2

For 3dfx users, you may disable the vertical sync refresh.  This can improve
proformance at the cost of some visual tearing of the image.  Entering the
following command into your shell before running Linux Q3A Demo will turn off
the vertical sync:

	export FX_GLIDE_SWAPINTERVAL=0

Then run Linux Q3A from the same command line normally.

A glibc compatible Linux installation is required.  An easy to determine
if you have glibc support is to type this:

	ls -l /lib/libc*

If you get a report of libc6 (you may also have libc5), you have a glibc 
based system. The binaries were created on a RedHat 5 (glibc-2.0.7) system.


--------------
(2)  X11 SETUP
--------------
Linux Q3A requires X11 to run. There is no console-based version as in
previous id products such as GLQuake and Quake2. XFree86 version 3.2 or
later is required.

There are two ways that mouse input is handled under XFree86:

        o By default, Q3A Demo will attempt to use DGA mouse handling. DGA
          support features direct reading of the mouse motion and provides
          more accurate control while playing the game. By default this
          support is enabled, but can be disabled by adding 
           "+set in_dgamouse 0" 
          to the command line at startup. This is recommended if you are
          using a Voodoo3 and are experiencing black screens, lockups,
          or mapping of mouse input to key events. This bug should be
          resolved on XFree86 SVGA 3.3.5 (except for a blue mouse cursor
          you might notice on the initial fullscreen frame). DGA mouse
          support does not require root privilege.

        o The non-DGA method of mouse input uses pointer grabbing and warps
          the pointer to the middle of the window on each mouse update. On
          systems with a slow frame rate and a lot of mouse user input, the
          motion can get "clipped" to the window boundaries. This method of
          input is more compatible however.

Q3A uses the XFree86 VidModeExtension facilities if available to provide
fullscreen play. This does not apply to 3dfx passthrough cards, since
the passthrough cable takes over the video display upon activation anyway.

When configuring your X11 server, make sure that you include lower
resolution modes such as 640x480 and 800x600. Q3A will auto-switch to
these modes using the VidModeExtension if you select fullscreen from the
graphics options menu. If the lower resolution modes are not listed in the
XFree86 configuration file, Q3A will be unable to switch to the desired
resolution for fullscreen play. Instead, it will using Mesa's software mode
to render into a window (very slow), or might fail to run at all, possibly
putting you in a different video in X11 on exiting.


---------------
(3) SOUND SETUP
---------------
Q3A uses the /dev/dsp sound device for sound support under Linux. This 
is the default device provided by the sound drivers included with the Linux
kernel. Please note that at the time of this writing, PCI based sound cards
such as the SoundBlaster Live and Diamond Monster MX series were not
supported. They may be supported in the future. Check
   
  http://www.opensound.com/ 

for support in the future.

You should make sure that the permissions for the /dev/dsp device are read 
and write for your current user ID. Some systems re-assign the owner and
reset to 644 on login. A simple way to get access is to do

  "chmod o+rw /dev/dsp" 

as root. For the more security conscious, a special sound group could be 
created and Q3A could be made setgid to the sound group to access the 
device.

Q3A uses mmap() to map the sound buffers on /dev/dsp directly in order 
to provide responsive sound needs. Sound cards must be able to support this
feature in order to work. SoundBlaster 16, AWE32 and AWE64 cards are known
to work.



--------------------
(4) PLAYING THE GAME
--------------------

By the time you read this, you will probably have succeeded in installing
from the self-extracting archive.

It is recommended that you do not run Q3A Demo using the root account or 
with root privileges. There are two exceptions to this:

        o If you are using a 3Dfx based accelerator card and do not install
          the /dev/3dfx configuration option. (You will have to run as root
          in order to access the card).
        o If you do not have access to the /dev/dsp device and do not wish
          to change the mode of the device so that non-root accounts can
          access it.

You will have to be running under X11 or have the DISPLAY variable pointed
to a OpenGL glX capable X Server.

By default, Q3A tries to find the following OpenGL libraries in this
order:

        o libGL.so
        o libMesaVoodooGL.so

You can override the library name by entering, "+set r_gldriver <libname>"
on the command line. This may be needed if you are using a non-standard set
up and have a different name for the OpenGL shared library. If you do not
specify a valid GL library, or if the GL library specified can't find or
access the hardware it expects, Mesa might fall back into slow software
rendering mode (usually in a window).

If everything proceeds successfully, you should have a Q3A Demo window on 
your desktop with a menu displayed (3dfx card owners will get a full screen
view). If you want to use full screen, go to the System Configuration, 
Graphics, Options, Fullscreen, change the value to Yes, and hit enter to 
apply it.

If you intend to connect to the Internet to play Q3A Demo, make certain
that your net connection is open and working first.

The first time you run Quake III Arena it will create a .q3a/ directory 
in your home directory.  Saved games and preferences will be stored here.

The demo offers an optional install of the HTML version of the manual, 
and more technical details on how to use Linux Quake III Arena. See
the Help/ folder. Point release updates and dedicated server only packages
do not contain the full manual.


----------------
(5) KNOWN ISSUES
----------------

Known issues for Beta3:
  The Mods Menu does not yet work under Linux.
  On some systems, Q3A exists with a Z_Free internal error message
   when deallocating packet data that was already freed.


For additional information, please see the FAQs maintained by id Software and Loki,

  http://www.quak3arena.com/faq/

  http://www.lokigames.com/support/quake3/
  http://www.lokigames.com/support/gldrivers/

Loki has also created a newsgroup devoted to discussion of Linux 
Quake III Arena:

  news://news.lokigames.com/loki.games.quake3



--------------------------
(6) CONTACTING ID SOFTWARE
--------------------------
If you encounter a bug in Q3A, particularly those involving
video or network bugs, please email a description of the bug to

  feedback@quake3arena.com 

Please do NOT send reports to individual id employees.

In your subject line, please describe the system the game is being played
on (Mac, Linux, Win32) and the type of problem you are reporting: video,
network, sound or game. Example Subject Line:  "Mac/video problem" or
"Linux/network connection problem."

In the body of your letter (no attached files please), briefly list and
describe the problems.  Detailed descriptions of problems are good, but
remember that brevity is best. Please do NOT send screen shots unless
they are the ONLY way to show a problem.

While we realize that you may have comments and suggestions regarding
specific game play features, please refrain from submitting such along
with bug reports. Comments on game play can be made on the official
Quake 3: Arena message board at:

    http://www.quake3arena.com/



------------------------------------------
(7) CONTACTING LOKI ENTERTAINMENT SOFTWARE
------------------------------------------
If you encounter a bug in retail Q3A, have problems with the installer,
or want to submit suggestions or corrections regarding the Linux version
of the HTML manual, please contact support@lokigames.com, or call us
using the phone numbers provided in the print manual.

You should also consider issuing a bug report at the Loki website, at

  http://fenris.lokigames.com/
  http://fenris.lokigames.com/enter_bug.cgi?product=Quake3

If you have encountered a bug with the demo version of Linux Q3A, we
would appreciate a bug report at the location above.

If you played the demo and consider purchasing the full version of
the game, you can order it from your local software reseller, or
buy online directly from Loki Entertainment Software at:

    http://www.lokigames.com/products/quake3/

or proceed directly to the order page at https://www.lokigames.com/.
The http://quake3.lokigames.com/ website will offer news about updates
and Linux projects relating to Quake III Arena. Further information
about the game in general can be found at http://www.quake3world.com/.



Enjoy!
- The Loki Quake III Arena Team
