*****************
 * Shopping list *
 *****************

To get NiL to run you will need:
* SDL:      http://www.devolution.com/~slouken/SDL/
* SDL_mixer http://www.devolution.com/~slouken/SDL/projects/SDL_mixer/index.html
* zlib:     Your distribution CD
* libpng:   Your distribution CD
* freetype: Your distribution CD or http://www.freetype.org
* NiL:      You have it:) or http://NiL.sourceforge.net


 **************************
 * Installing from binary *
 **************************

No, you don't want to be installing NiL just yet, but here is a
short guide to get it running from the binary package:
 
* Install SDL, SDL_mixer, zlib, libpng and freetype, if you are lucky you can
  find an rpm or a deb for each of them.

* Unpack the nil-binary-*.tar.gz tarball.

* Run: ./nil

* Read the section "Running NiL"


 **************************
 * Installing from source *
 **************************

* Install SDL, SDL_mixer, zlib, libpng and freetype, if you are lucky you can
  find an rpm or a deb for each of them.

* Go to the NiL source directory change to nil and do the normal
  ./configure && make this should leave an executeable in
  the next nil directory (mine is: /home/ff/nil/nil/nil).

* Run: ./nil mode=clientserver data=/home/ff/nil/gfx/ripped data=/home/ff/nil/gfx/original
  replacing the paths with the appropriate ones for your setup.

 * Read the section "Running NiL"

  
 ***************
 * Running NiL *
 ***************
 
To just run nil just use "./nil" this will start a client
and also fork off a server.
  
You can also run a dedicated server with ./nil mode=server and
then connect to it from a machine somewhere using
./nil mode=client server=nilserver.domain.org

If you move the data file (default.lump) around then you can
tell nil where to find it with data=/usr/share/nil/default.lump

You can put all these options in a file (~/.nilrc) and nil will
use that as default.

Every time NiL is run it saves all the configuration options to
~/.nilrc.last_good this file is commented and holds all the
options that nil understands, once you have run nil once go and
read this file to see what options NiL supports.
 
  
 ********
 * Keys *
 ********  
  
Once everything is running the keys are:

Arrows: aim/walk.

Ctrl: fire.
Alt: dig.
Shift: jump.
z: fire hook.
x: release hook.
a: shorten hook bungee
s: lengthen hook bungee

1: experimental gun.
2: minigun
3: shotgun.
4: super shotgun.
5: railgun (yeah baby)

The function keys do things like:
 toggle dropshadow.
 dump screenshot.
 toggle traffic graph (100% is 128kb/s)
 Turn on and off the nifty logo


  
 ******************
 * Installing PTC *
 ******************

This is generally not needed, it is just here for reference
in case anyone wants to play with the 

Get this for playing around with the obsolte code:
* Hermes: http://hermes.terminal.at
* PTC: http://www.cs.ucl.ac.uk/students/c.nentwich/ptc/
* Titan: http://www.geocities.com/SiliconValley/Station/7463/index.htm

* install Hermes, make sure that the directory containing
  libHermes.so (default: /usr/local/lib/lib) is listed in
  /etc/ld.so.conf if it's not add it.

* install PTC.

* Run: ldconfig