SuperWaba Virtual Machine - Runtime Environment
===============================================

This document describes the installation procedure of SuperWaba for
end users. Developer should download the SDK from
http://www.SuperWaba.org. The Runtime Environment can be downloaded
at http://www.SuperWaba.org/install.


GENERAL REQUIREMENTS:
=====================
SuperWaba runs on most PDAs with PalmOS and most Windows CE/PocketPC
models with WinCE 2.11 and higher. SuperWaba as of version 4.01
is known NOT to run on the following devices:

 * Visor (with PalmOS 3.1H1)
 * Sony NR70 Japanese Version


PalmOS INSTALLATION:
====================

Download and install the following files:

. For Palm OS 5 devices, for programs that do not use colorful images (and for Zire 21)
  ­ Download file PalmOS5_ARM_8bpp.zip
  Install at least the following files on you Palm:
      · SuperWaba.prc
      . SuperWaba.pdb

. For Palm OS 5 devices, for programs that DO use colorful images (NOT for Zire 21)
  ­ Download file PalmOS5_ARM_16bpp.zip
  Install at least the following files on you Palm:
      · SuperWaba.prc
      . SuperWaba.pdb

· For Palm OS 3, or Palm OS 4 devices that works only in 8 bits per
pixel screens
  ­ Download file PalmOS3_or_4_with_8bits_screen.zip
  Install at least the following files on you Palm:
      · SuperWaba.prc
      · SWNatives.prc
      . SuperWaba.pdb

· For Palm OS 4 devices that works only in 16 bits per pixel screens
  (Kyocera 7135)
  ­ Download file PalmOS4_with_16bits_screen.zip

  Install at least the following files on you Palm:
      · SuperWaba.prc
      · SWNatives.prc
      . SuperWaba.pdb

. For Zire 71 device and others that may reset alone (the device
  reboots alone)
  - Download file PALMOS_AutoReset.zip

  Install at least the following files on you Palm:
      · SuperWaba.prc
      · SWNatives.prc
      . SuperWaba.pdb

After this installation-process, you should see a new program called
SuperWaba on your Palm. Launching this program will give you a welcome
screen of SuperWaba and you know that the installation of SuperWaba
succeeded. The other files coming with SuperWaba are additional
libraries which might be used by applications. You should install
those only when mentioned by an application you intent to install.
Some SuperWaba examples included in the SDK require them, so don't
forget to check the SuperWaba.pdf file (included in the SDK), or in
this link: http://www.superwaba.org/etc/SuperWaba.pdf


General Installation of Programs which use SuperWaba under PalmOS:
------------------------------------------------------------------

Each program which uses SuperWaba consists of at least two files:

  · PROGRAM.prc
  · PROGRAM.pdb

where PROGRAM is the name of the program to be installed. Several
programs come with additional .pdb or .prc files, and might require
the installation of some of SuperWaba's additional libraries, as
stated in the program's documentation.


Windows CE / Pocket PC INSTALLATION:
====================================

Find out version the platform and processor your handheld is using.
Possible platforms are HPC2000 (Hand PC 2000), HPC211 (Hand PC v. 2.11),
PPC211 (Palm-sized PC) and PocketPC (AKA Windows CE 3.0); possible processors
are MIPS, SH3 and ARM. Open Internet Explorer from within your handheld,
choose this page and download the zip file with the correct
platform_processor combination.

  * SuperWaba.PLATFORM_PROCESSOR.cab

After this installation-process you should see a new program called
SuperWaba on your PDA. Launching this program will give you a welcome
screen of SuperWaba and you now that the installation of SuperWaba
succeeded. The other files coming with SuperWaba are additional
libraries which might be used by applications. You should install
those only when mentioned by an application you intent to install.
Some SuperWaba examples included in the SDK require them, so don't
forget to check the SuperWaba.pdf file (included in the SDK).


Windows 98 / ME / NT / 2000 / XP INSTALLATION:
==============================================

. Please download the file win98_and_beyond.zip
  Expand this file in a folder called c:\SuperWaba (don't expand the folders
  inside the zip file).
  You can then click the SuperWaba.exe program to see that the VM is correctly
  installed. The VM stored in this file lets you test all SuperWaba programs
  in the Windows 32-bits operating systems. To run a program, you must install it
  in a folder under the c:\SuperWaba (the same folder you use for the Windows CE /
  Pocket PC installation).


General Installation of Programs which use SuperWaba under Windows PDA:
-----------------------------------------------------------------------

Most programs can be installed in the same way SuperWaba has been
installed, using a cab file. Download the program, then search for a bat
file called PROGRAM_install.bat. Launch it and the installation will start.
And don't forget to read the program's documentation.


LICENSE:
========
SuperWaba can be used under the
GNU GENERAL PUBLIC LICENSE

Read the file http://www.superwaba.org/gpl.txt (also included
in the SDK).


TRANSLATION OF THIS FILE
========================
If you translate this file to your language, send it to the webmaster
of the SuperWaba site so it can be included here.