-Incorporated Marcin Ko��cielnicki patch that reintroduces the flying
[supertux.git] / INSTALL
1
2 - Install instructions for SuperTux -
3 http://super-tux.sf.net/
4
5 Last update: April 26, 2004
6
7 REQUIREMENTS
8 ------------
9
10   CONTROLS
11   --------
12     The game can be played with either a the keyboard or a joystick.
13
14   SDL
15   ---
16     "SuperTux" was programed using the "Simple DirectMedia Layer"
17     libraries by Sam Lantinga.  This means that the game can
18     theoretically run under any environment that the SDL libraries support.
19
20     (As of this program's release, this includes: Linux X11/DGA,
21     Win32 WinDIB/DirectX, BeOS BWindow, and Solaris X11, as well
22     as unofficually supported: Linux SVGAlib, IRIX 6.x X11,
23     FreeBSD 3.x X11, and MacOS.)
24
25     The Simple DirectMedia Layer is required to compile this game.
26
27     You can download the SDL libraries from:
28       http://www.libsdl.org/
29
30   SDL_image
31   ---------
32     SDL_image is also required.  (It is used to load the PNG format images
33     that come with SuperTux!)
34
35   SDL_mixer
36   ---------
37     Sound and music are available, but are not required (see below).
38     You will need the "SDL_mixer" library compiled and installed if
39     you want sound.
40
41   OpenGL implementation (optional)
42   ---------------------
43     Mesa should be installed in order to compile, but it is painly
44     slow when running, so we advise you to install your videocard
45     drivers (of course, it has to be an accelerated videocard).
46     For linux, nvidia vendor is the only one that makes decent drivers.
47     But the ATI drivers should run with the same performance, since
48     it only uses accelerated 2d, not 3d.
49
50     Anyway, you can use the SDL frontend and you most likely won't
51     notice any difference.
52
53
54 INSTALLING UNDER LINUX/UNIX
55 ---------------------------
56   -----------------------------------------------------------------
57   Note: Read this entire section before you start issuing commands!
58   -----------------------------------------------------------------
59
60   SuperTux uses a script that checks for dependency and disables
61   features, in case they are not found.
62   The script is the configure and you can specify a few stuff
63   like the directory to which you want to install SuperTux,
64   by giving the argument --prefix=/usr/local (ie). For more
65   informations, type './configure --help'.
66   (Note: SuperTux does not need to be installed in the system,
67   you can run it from its own directory.)
68
69   If there isn't any configure script (ie. in case, you got it
70   via cvs), just run the autogen.sh script.
71
72   To compile it, a 'make' is enough.
73   Type 'make install' (as root) to copy it into the system.
74   (default directory is /usr/local, see above how to change
75   this.)
76
77   So, in short, just type:
78   sh autogen.sh (in case there isn't any configure file already)
79   sh configure
80   make
81
82   And in case you want to copy SuperTux to the system:
83   make install (as root)
84
85
86 ICON FILE
87 ---------
88   A 32x32, XPM-format icon file is available if you wish to use
89   an icon for a menu entry for this game.
90
91   The file is "supertux.xpm", and can be found at  the data/images/
92   directory.