1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196
|
If you are having problems installing the software or want a step-by-
step guide to building and using the Adonthell software, please look
at the NEWBIE file. If you just want the quick-start version of the
install process, here it is.
Should you still have problems, please visit our tech support at
http://savannah.gnu.org/support/?group_id=702 .
Requirements:
=============
There are sixlibraries that Adonthell depends on:
1. Python, version 2.0 or later.
See http://www.python.org/
2. SDL, version 1.2 or later.
See http://www.libsdl.org/
3. SDL_mixer, version 1.2 or later.
See http://www.libsdl.org/projects/SDL_mixer/
4. SDL_ttf, version 2.0 or later.
See http://www.libsdl.org/projects/SDL_ttf/
5. Freetype, version 2.0 or later.
See http://www.freetype.org/
6. Ogg Vorbis, version 1.0rc3 or later
See http://www.xiph.org/ogg/vorbis/download/
Installing:
===========
From source:
------------
In the toplevel adonthell-0.3 directory type
$> ./configure
$> make
and (as root)
$> make install
For more information, see the README file. Problems? Don't have
the right libraries? Please look at the NEWBIE file or our website
for answers:
http://adonthell.linuxgames.com
Debian users:
-------------
You can automatically get an installable Debian package by typing
$> debuild
within the adonthell-0.3.5 directory. 'debbuild' is part of the
'devscripts' package. Check carefully that you have the python2.2,
python2.2-dev, libsdl1.2 and libsdl1.2-dev packages installed (plus
libvorbis0 & libvorbis-dev if you want sound), or the build will fail.
RPM users:
----------
To create an installable RPM package, type
$> rpm -tb adonthell-0.3.5.tar.gz
Note that the 4.x versions of rpm are currently unsupported. Feel free
to change that, if you want. For more information, refer to section 8.0
of the NEWBIE file.
Advanced configure options:
===========================
There are a number of options to 'configure' that might be useful
for you. For a complete list, run 'configure --help'.
--enable-py-debug
This option turns on debugging output of the embedded python
interpreter to locate bugs in our python scripts. If Adonthell
behaves odd or hangs with no apparent error message, turning
on Python debugging might reveal the source of error. On slower
machines, you shouldn't enable this option unless you need it -
it may considerably increase Adonthell's CPU usage.
--enable-tools
Use this to build the Adonthell development tools. These will
include editors for our graphic objects, characters, maps, dialogues
and a few other utilities. Note that non of these tools will be
installed when running 'make install'. You will have to run them from
their source directory or install them manually.
--enable-doc
Use this to build the Adonthell source code documentation. For
this to work you will need two additional tools: doxygen and dot.
See http://www.doxygen.org
for the first. Latter is a part of AT&T's graphviz toolkit which
can be found at
http://www.research.att.com/sw/tools/graphviz/.
The documentation will end up in doc/<subdir>/html/ respectively
doc/<subdir>/latex/, where subdir is one of devel or dlgedit. It
is also made available for online browsing at our website,
http://adonthell.linuxgames.com.
--enable-memleaks
This enables support for mtrace, a tool to find memory leaks.
After compiling you have to set the $MALLOC_TRACE environment
variable to any file. Running Adonthell will record debugging
information in this file. Use 'mtrace adonthell $MALLOC_TRACE'
to finally display any occurrence of memory leaks.
A much more convenient way to check for memory leaks is the
'memprof' tool: http://people.redhat.com/~otaylor/memprof
Even better than memprof, but not as easy to use is valgrind:
http://developer.kde.org/~sewardj/
--with-included-gettext
If you want to build Adonthell with national language support (NLS),
you'll have to use this option on systems that do not provide the
required services themselves.
--disable-nls
Use this option to disable NLS completely. For more information
regarding this and the previous option, read the ABOUT-NLS file in
this directory.
--disable-sdltest
--disable-vorbistest
--disable-gtktest
If configure claims to not find the SDL library, Ogg Vorbis or
GTK+ although they are there, or if you try to cross-compile,
you can disable the respective test.
Another way to workaround such a problem might be to recreate
'configure' by running the 'autogen.sh' script.
--with-<x>-prefix=PFX
This allows you to specify the path to various libraries. (replace
the <x> with the name of the library.) This is useful if you have
installed those libraries in unusual locations, although it might be
better to set the $LD_LIBRARY_PATH environment variable, or to add
those directories to /etc/ld.so.conf.
--with-dir=DIR
Use this option to customise the location of the data directory.
The default is /usr/local/share/adonthell. Once you have compiled
Adonthell you can query the data directory with 'adonthell -d'.
*********************************************************************
* That's it! Enjoy the game engine and let us know what you think!! *
*********************************************************************
- The Adonthell Team
|