1Hu-Go! installation instructions
2================================
3
4See INSTALL.gnu for the usual instructions once the development environment is set up.
5
6Linux development environment
7=============================
8
9As it is a real OS, you probably don't need much to make it usable for building Hu-Go!
10You need :
11- gcc (2.95 seems to produce core dumps sometimes, gcc-3.0 and more recent doesn't)
12- gnu make
13- gtk development libraries (check packages for your distribution if needed) [optional but recommended]
14- zlib development libraries (ditto) [optional but recommended]
15
16Those were very common and you're extremely likely to already have them.
17
18- sdl development library (check packages for you distribution or go to www.libsdl.org)
19
20the usual './configure && make'
21and then 'make install' as root should work flawlessly. Some warning may happen (10-20), you
22can safety ignore them.
23
24Linux -> Windows development environment
25========================================
26
27You need to install a cross compiler linux -> windows, mingw (debian users can install
28it with apt)
29
30You need to have all windows gtk needed libs (see the next section) and sdl development
31libraries for windows. Copy the include and lib files in the include and lib directory
32of mingw installation.
33
34'gtk-config' in hugo sources is to be put on the bin subdir of the mingw installation
35so that it behaves like the linux version.
36
37Last thing, since you have to set a path and then call ./configure with argument to
38force an host which isn't the one building the program, you can use the
39'./cross-configure' script included in hugo sources. Then, simply use 'make'.
40
41Alter paths in those two scripts to match your real directory structures. The changes,
42if any, are really easy to spot.
43
44Native Windows development environment
45======================================
46
47You need to grab the native mingw environment and msys (so you get a shell,
48a compiler, make, ...) (see www.mingw.org, install mingw and then msys).
49
50You need to grab the sdl development libraty for mingw on www.libsdl.org.
51Install it in the mingw directory (so that SDL.h is in the include subdirectory
52of the mingw main directory, etc ..)
53
54Now, the most difficult part, the windows port of gtk. You can go there :
55http://www.gimp.org/~tml/gimp/win32/downloads.html
56There, grab :
57 - gtk+-dev
58 - libiconv-bin (you'll have to move the .dll in it into the lib subdir of mingw)
59 - atk-dev
60 - gettext-dev
61 - pango-dev
62 - glib-dev
63
64Installation is easy, as you simply unzip them in the mingw main directory (you can
65use enzip [http://www.cpam.freeserve.co.uk/] if you don't have an unarchiver).
66
67You should then replace the gtk+-1.3-win32-production.pc installed by the one provided in
68hugo sources (in the extra_dev subdirectory) (replacing the path if needed) (it adds
69-mms-bitfield option needed for gtk to compile properly).
70
71You should finally put the gtk-config script provided (in the extra_dev subdir)
72into the bin directory (changing the path, as usual) so that you can call gtk
73script in an homogeneous maneer.
74
75If you can compile the usual hello world program (see http://gtk.org) with
76gcc -o hello hello.c `gtk-config --cflags --libs`, then you're ready to compile
77hugo with ./configure && make.
78
79FreeBSD development environment
80===============================
81
82See the linux notes.
83A few details : sdl config script is called slightly differently (sdl11-config).
84You can simply make a link called sdl-config toward it. It should be the only
85difference with the linux instructions.
86
87Solaris development environment
88===============================
89
90I have only tested on Solaris 9 for Sparc so far.
91I used the GNU tools, either for compiling (gcc), for handling makefiles
92(gmake) and for generating configure scripts (autoconf/automake). The
93generation of configure scripts is only relevant for people using the CVS
94tarball, else it's already "compiled" and ready to execute.
95Just like other OSes, you'll need SDL, zlib (already handy if my memory serves).
96
97See the linux notes then.
98Just a little note, I personnaly had to use the following line to launch
99configure :
100MAKE=gmake LDFLAGS=-L/usr/local/lib CPPFLAGS=-I/usr/local/include/SDL ./configure
101
102to accomodate the gnu make name under Solaris and the location of SDL libs.
103