File: INSTALL

package info (click to toggle)
adonthell 0.3.8-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,416 kB
  • sloc: cpp: 50,659; sh: 5,142; python: 3,307; makefile: 338; lex: 216; sed: 16
file content (168 lines) | stat: -rw-r--r-- 4,489 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
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 six libraries that Adonthell depends on:

1. Python, version 2.2.1 or later. 
   
   See http://www.python.org/


2. SDL, version 2.0 or later.

   See http://www.libsdl.org/


3. SDL_mixer, version 2.0.0 or later.

   See https://www.libsdl.org/projects/SDL_mixer/


4. SDL_ttf, version 2.0.12 or later.

   See https://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/downloads/


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.nongnu.org



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-dlgedit

  Use this to build the Adonthell dialogue editor. Note that 
this requires additional dependencies for compilation, namely
Cairo 1.2.6 or higher and GTK+ 2.18 or higher.


--disable-pyc

  This option can be used to disable byte-compiling any included
python scripts. Instead of compiled (.pyc) files, the raw (.py)
source files get installed upon 'make install'.


--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.


--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/


--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-freetypetest

  If configure claims to not find the SDL library, Ogg Vorbis or
Freetype, 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-data-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