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
|
WABA RELEASE 1.5
TO COMPLETE BEFORE RELEASING 1.6:
- Requirements
- Specific ./configure options for Waba.
- installation of binaries
- tested on
- file HISTORY
+--------------+
| INTRODUCTION |
+--------------+
This directory has the latest Waba Virtual Machine.
Report any bugs to waba@smartdata.ch
Main web site is http://waba.sourceforge.net/ -- see that site for the
latest updates.
To see difference with the latest version, see the file HISTORY.
+--------------+
| Requirements |
+--------------+
Every GTK based installation need at least GTK version 1.2.0.
If you want to use the PicoGUI graphical interface, please install it
from http://pgui.sourceforge.net/. Since either PicoGUI and Waba are
in active developement, the current implementation of Waba use the
last CVS version of PicoGUI. Please note using PicoGUI is not fully
supported now, so use it at your own risk.
You can cross-compile from Linux for uClinux 2.0, PalmOS and WIN32
target. Maybe other targets can be used, but no tests was done.
To cross-compile for uClinux, you need tools from uClinux distribution.
See the file README.uClinux for more informations.
To cross-compile for PalmOS, you need prc-tools
(http://prc-tools.sourceforge.net/) and PilRC (http://www.pilrc.com/).
To cross-compile for WIN32, you need "Minimalist GNU For Windows"
(http://mingw.sourceforge.net/). RPM binary for Linux is available at
http://www.devolution.com/~slouken/SDL/Xmingw32/
+-----------------------------------------------------+
| Installation from the tar/zip sources distributions |
+-----------------------------------------------------+
If you are reading this file, it's certainly mean you already have
downloaded the archive, and explode it. If not, go to the main waba
site http://waba.sourceforge.net/, download latest source distribution
and explode it with the correct tool.
1. For the impatient :
----------------------
./configure
make
make install
2. Details of the installation :
--------------------------------
a. ./configure
--------------
./configure has a lot of options. To have the full list, just type :
./configure --help
Specific waba options are :
--with-prefix=<tool prefix>
Specify the prefix to use with gcc, ar, ... For example :
--with-prefix=m68k-palmos will compile with the m68k-palmos-gcc compiler.
--with-buildprc=/path/to/build-prc
Specify the build-prc path if needed (default to build-prc)
--with-warp=/path/to/warp
Specify the warp path if needed (default to warp)
--with-exegen=/path/to/exegen
Specify the exegen path if needed (default to exegen)
--with-nogui
Build a Waba VM with a "NULL" graphics library instead of the GTK default
--with-pgui
Compilation for PicoGUI instead GTK
--with-glib
Use this if you want to use glib with PicoGUI for the definition of types
--enable-debug
If you want to have a code with debug information
Others usefull options are :
--prefix=/where/to/install
a1. cross-compilation
"""""""""""""""""""""
A typical configuration line to cross-compile for a uClinux version is :
./configure --with-pgui=/path/of/pgui_for_m68k --with-prefix=m68k-pic-coff
A typical configuration line to cross-compile for a PalmOS version is :
./configure --with-prefix=m68k-palmos
A typical configuration line to cross-compile for a WIN32 version is :
./configure --with-prefix=i386-mingw32msvc
Note cross-compilation requiere developements tools for uClinux,
PalmOS and/or WIN32 installed on your system. See "Requirements"
chapter for more informations.
b. make
-------
make will go trough all the directories and compile everything it's needed.
c. make install
---------------
make install will install all the needed files in the given prefix. By default,
it install :
- binaries in /usr/local/bin
- classes in /usr/local/classes
- samples in /usr/local/examples
d. use of the Waba VM
---------------------
You first need to have correct paths for PATH and CLASSPATH. For a
default installation, you need to have /usr/local/bin in your PATH and
/usr/local/classes in your CLASSPATH. Then you can try to do:
waba
This will display an about box. To run examples, to something like :
waba /usr/local/examples/CoreTest/CoreTest
If you need help existing running options, use -h :
waba -h
+------------------------------------------------------+
| Installation from the tar/zip binaries distributions |
+------------------------------------------------------+
TO COMPLETE WHEN RELEASE 1.5 is OUT
+-----------------------------------+
| Installation from the CVS sources |
+-----------------------------------+
CVS version is the actualy on heavy developement. Use this version
only if you want to contribute, or if you really need a feature not
allready in a distributed version.
Using the CVS sources implies your known the basic use of CVS
(http://www.cvshome.org/). It also implies you have some basic
development tools installed, in particular autoconf and automake (see
http://www.gnu.org/ for more informations about them).
To get the actual cvs version, you can do (just hit return when asked
for a password):
cvs -d:pserver:anonymous@cvs.waba.sourceforge.net:/cvsroot/waba login
cvs -z3 -d:pserver:anonymous@cvs.waba.sourceforge.net:/cvsroot/waba co .
Then prepare the sources with :
./autogen.sh
Remaning steps for the installation is the same as installing from
the tar/zip sources distributions.
+-----------+
| Tested on |
+-----------+
The current version was tested on :
- Linux 2.4.4 with GTK 1.2.8.
- Linux 2.4.4 with PicoGUI CVS.
- FreeBSD 4.1.1 with GTK 1.2.8.
- Solaris 7 with GTK 1.2.8.
|
