KeyGrip 2.0.36 README
By David 'crt' Wright
___________________

     I    Info and Disclaimer

     II   INSTALLATION INSTRUCTIONS *IMPORTANT*
     
     III  Starting and running KeyGrip 2

     IV   Misc Important info

     V    Web site and contact information

     VI   Version Info
______________________________________
Please read this Entire File BEFORE running KeyGrip 2
Failure to do so may result in incorrect program operation.
It is also a good idea to read the keygrip2.hlp file so you will
understand how to USE the program.
The documentation is now in Windows Help format. You can
access it at any time by using F1.

The following is from the GNU Public license, and is a general
disclaimer for KeyGrip 2. This does not mean that KeyGrip 2 is
distributed under GPL. See KeyGrip2.hlp for commercial
use/distribution info.
          BECAUSE THE PROGRAM IS LICENSED FREE OF
     CHARGE, THERE IS NO WARRANTY  FOR THE
     PROGRAM, TO THE EXTENT PERMITTED BY
     APPLICABLE LAW.  EXCEPT WHEN  OTHERWISE
     STATED IN WRITING THE COPYRIGHT HOLDERS
     AND/OR OTHER PARTIES  PROVIDE THE PROGRAM
     "AS IS" WITHOUT WARRANTY OF ANY KIND,
     EITHER EXPRESSED  OR IMPLIED, INCLUDING, BUT
     NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
     MERCHANTABILITY AND FITNESS FOR A
     PARTICULAR PURPOSE.  THE ENTIRE RISK AS  TO
     THE QUALITY AND PERFORMANCE OF THE
     PROGRAM IS WITH YOU.  SHOULD THE  PROGRAM
     PROVE DEFECTIVE, YOU ASSUME THE COST OF
     ALL NECESSARY SERVICING,  REPAIR OR
     CORRECTION.
Thanks to id for Quake 2, Uwe Girlich for LMPC, Basty and the
PlanetQuake crew for their support.
Thanks to Warped (warped@planetquake.com) for the splash
screen logo.
Finally, the MVP beta tester award goes to P2-Geburah, who also
made the awesome P2-CTF movie.
                   

II.     INSTALLATION INSTRUCTIONS *IMPORTANT*
_____________________________________________
Please follow these directions exactly.
Do not just extract all the files into a directory and run.

1.  Make a directory for the files, and extract the ZIP to it.
    (e.g. c:\games\quake2\keygrip2)

2.  Keep
        KeyGrip2.exe
        KeyGrip2.dll
        *.txt
        *.hlp, *.cnt
    in that directory

3.  Move the kg2demo.cfg file to your baseq2 directory
(e.g. c:\games\quake2\baseq2)

4. Move the example demos (*.dm2) to your \baseq2\demos directory

5. Move the sounds for the tutorial (*.wav) to your \baseq2\sound
directory (create it if it doesn't exist).

III.    Starting and running KeyGrip 2
_____________________________________________

YOU MUST HAVE TCPIP INSTALLED AND CONFIGURED
ON YOUR SYSTEM. SEE TCPIP.TXT FOR MORE INFO.

1. For best performance, you may want to shut down other running
applications (Netscape, MSIE, and MS Outlook are huge memory
hogs). Also, if buttons start showing up without glyphs
(icons/pictures) on them, you are running out of resources. Try
quitting and restarting KeyGrip 2.

2.  KeyGrip 2 is resolution independent, and should work fine as
low as 640x480. However, for best performance, at least 1024x768
is recommended. 16-bit (or higher) Color is required for proper
image display. Large fonts should work OK. If status bars are being
cut off, or things look out of place, try small fonts.

3.  Run keygrip2.exe. If it crashes on startup, install Winsock 2.
The URL is in tcpip.txt. If you already have Winsock 2, reinstall it.

4.  You will need to configure the Quake 2 directory in the dialog
box. For a description of the many other options, see keygrip2.hlp.

5.  After you have done this, you should be left with the program
open, a bunch of grayed out icons (and some enabled) and a big
open workspace. I recommend resizing the main window so that it
covers the top half or so of your screen. Running maximized is not
recommended.


IV. Misc Important Info
_____________________________________________

If you are getting a GPF in your display driver, try getting an
updated driver. If that doesn't work, get DirectX5 drivers.

You should not run KeyGrip 2 fullscreen. If you run it half-screen,
you can put Quake 2 in the bottom left corner, and still have room
for the Block Tree and other dialogs on the bottom right corner of
the screen.

Currently KeyGrip 2 has a 32,500 block limit. Opening demos this
large would not be healthy for your system anyways (almost an
hour long).

V. Website and contact information
_____________________________________________

KeyGrip 2 is generously hosted by PlanetQuake
(www.planetquake.com). The official homepage is:
http://www.planetquake.com/keygrip

The Author is David 'crt' Wright and may be contacted at:
wrightd@stanford.edu

For demo related questions, you may wish to speak with Chris
'Drastic_Man' Sykes:
dmp@dc.jones.com

Please report any bugs to crt at the above address. Features that are
not currently functional (such as File-New) are not considered bugs
and should not be reported. Please check the KeyGrip 2 page for
bug reports/fixes before sending anything in. Be as descriptive as
possible, and include any relevant screenshots/demos with your
bug report.

There is a large FAQ section in the help file. Be sure to check there
first.


crt is also the programmer of Rocket Arena 2 for Quake 2
http://www.planetquake.com/servers/arena

VI. Version Info
_____________________________________________
2.0.21
* First private beta release. All features enabled. No known bugs.

2.0.25
* Second private beta release. Many reading/writing bugs fixes.
Sound and model lists redone (again). Help file added! Toolbars
redone.

2.0.31
* Third Private Beta, 3.17 SR demo support

2.0.34
* Forth Private Beta, Added remove extra entities button, multiple columns in
find params, fixed 3.17 old_origin bug.

2.0.35
* Final private beta, fixed frame errors in SR delta'd demos. Added MOTD support.

2.0.36
* First Release. Fixed math errors in remove non-visible entites