This is the Linux/GCC port of SuperWaba using SDL


+INTRODUCTION
--------------

Like all serious Linux open source project, the build is based on the 
GNU build system (autoconf/automake). This should allow a build of the VM 
on any Linux flavour (in theory at least... It may require some fine tuning 
to support some older distribs).
It should run without any issue on Redhat9.0 and debian "sarge".

An "rpm" target to build a binary release "superwaba-5.x.y-z.i386.rpm" and it's source
counter part "superwaba-5.x.y-z.src.rpm" have been added to the standard GNU makefile
targets "all", "dist", "install", "clean" ...

The debian binary package can be generated by converting the rpm package to a debian
package with the "alien" tool. Use the "deb" target.

The binary superwaba rpm contains the files with the following file structure
compliant with the GNU standard Linux filesystem structure.

RPMs are installed regarding a prefix dir, in general "/" or "/usr" for 
system components and "/usr/local" for external applications.
The default install prefix for the Linux SuperWaba/VM is "/usr/local"

-%prefix/bin/superwaba

is the script to run the VM, it loads user preferences (command line options) 
through a user specific "$HOME/.superwabarc" preferences file.
The script should be installed in a "bin" folder that belongs to the 
standard PATH (=/usr/local/bin:/usr/bin:/bin:/usr/X11R6/bin)

The other VM files are:

-%prefix/lib/superwaba/MSW.pdb
-%prefix/lib/superwaba/superwaba.bin
-%prefix/lib/superwaba/superwaba.pdb
-%prefix/lib/superwaba/XPlatGame.pdb
-%prefix/lib/superwaba/XPlatIoUIUtil.pdb
-%prefix/lib/superwaba/XPlatUtilProp.pdb

You should now be able to start the VM. To run it, just enter:

bash$ superwaba

and a window should appear... hopefully

To display the commandline help, run:

bash$ superwaba --help
Superwaba VM version 5.0.0 (c) 2004     => www.superwaba.com
Usage: superwaba [OPTION...] [class-name] [class-path] [creator-id]
 
        -w, --width  = <pixels>    window width
        -h, --height = <pixels>    window height
        -x, --xpos = <pixels>      desired window horizontal position
        -y, --ypos = <pixels>      desired window vertical position
        -F, --full                 fullscreen mode
        -p, --path = <dir>         path to the PDB
        -t, --title = <text>       window title
        -v, --version              product version
        --help                     usage help

Edit your preference file at $HOME/.superwabarc
to set a 320x320 resolution and run superwaba again. 


If you have question concerning this product, you can ask one of the 
forums described at http://www.superwaba.com.br/en/forums.asp

Visit the Superwaba homepage at http://www.superwaba.com for the latest news.
                                                                                
That's it!
Frank Diebolt <fdiebolt@nospam.superwaba_nospam_com.br>
