File: INSTALL

package info (click to toggle)
adonthell 0.3.5-7.1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 5,288 kB
  • sloc: cpp: 44,102; sh: 9,553; python: 1,902; makefile: 212; lex: 51; sed: 16
file content (196 lines) | stat: -rw-r--r-- 5,369 bytes parent folder | download | duplicates (4)
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