These files were taken from the WExtras class, package wababin
Copyright 1999-2001 Rob Nielsen
Enhanced by Guilherme Campos Hazan for SuperWaba 2 and 3

To learn how to compile your applications using them, please see the make.bat files at the examples directory.

There are 4 callable files in this directory:
. warp - pachages your class files into a pdb
. exegen - creates an "executable" file that calls the vm inside the device
. RenameFont - renames a font pdb file so it fits in the SuperWaba Font-Name Pattern.
. Wxgn - calls warp and exegen with one only command

@@@@@@@@@@@@@@@@@@@@@@@@@ Warp Instructions @@@@@@@@@@@@@@@@@@@@@@@@@
Usage: java Warp command [options] warpfile [files]

Commands (case insensitive):
   c   Create new warp file
   l   List contents of a warp file

Options (case insensitive):
  /?   Displays usage text
  /c   Override and assign PDB database creator (e.g. /c CrTr)
  /r   If a directory is specified in the files, recurse any subdirs
  /q   Quiet mode (no output except for errors)
  /$   Set the Palm OS copy protection attribute
  /x   Specify a list of package/class names whose classes won't be added.
       You can specify a list without spaces as 'class1,class2/,package1,...'
       . The files whose full package name starts with the given string
       . The files whose class name starts with the given string
       . If string ends with \, only the whole class name is used for compare
       E.g.:
       /x extra,jgui.sio.server,NativeMethods4JDK,Graphics\
       -> packages extra.* and jgui.sio.server are excluded,
       -> all class names starting with NativeMethods4JDK are excluded,
       -> Graphics class is excluded (but GraphicsNat is included)
  /i   Specify a list of package/class names whose classes will be the only
       ones that will be included. The opposite of /x option.
  /ll  Specify that this file will be a SuperWaba Local Extension Library.
  /lg  Specify that this file will be a SuperWaba Global Extension Library.

This program creates a .pdb file, used in all SuperWaba platforms.
The creator will be generated automatically from the name of the pdb file
if not overridden with the /c option.

The input file can be a Jar (in this case, all .class and .bmp files in the
jar will be added).

Warp will automatically check any class files for dependencies and add
these files so you will only need to specify the main class file and
everything else will be added automatically, even directly referenced
.bmp files. (ie. Image im=new Image("rob.bmp)
If no input files are specified, it will look for a .class file with
the same name of the pdb file you are creating.

Examples:
   java Warp c HelloApp
   java Warp c /c Crea HelloApp helloapp.jar
   java Warp c helloApp *.class util\\*.class
   java Warp c /r helloApp extra\\
   java Warp c /lg wextrasLib *.class extra\\
   java Warp l helloApp.pdb



@@@@@@@@@@@@@@@@@@@@@@@@@  Exegen instructions @@@@@@@@@@@@@@@@@@@@@@@@@
Usage: java Exegen [options] exefile [main-window-class] [pdbfile]

Options (case insensitive):
  /?   Displays usage text
  /$   Turns on the PalmOS copy protection attribute
  /C   Override and assign PDB creator (e.g. /c CrTr)
  /H   Assign height of application's main window
  /W   Assign width of application's main window
  /P   Subdirectory name for the application under Windows CE. Note that
       in SuperWaba all applications stay under SuperWaba at '\SuperWaba'
       Spaces, /, \ and " in the directory name are not alowed.
  /V   Assign the version for the application
  /Z   Creates CAB installation files to deploy your application
  /E   generates .exe files for Windows CE and Pocket PC.
  /L   generates .lnk file for Windows CE and Pocket PC.
  /I   Specifies the icon PREFIX.

This program generates a Palm OS .prc and Windows CE application .exe files
These executables are used to launch (start up) a SuperWaba program.

If you don't specify the pdb file, its name will be the same of the exefile.
If you don't specify the [main-window-class], its name will be the same of
the exefile too

File extensions are generated automatically. For example, if you specify
myapp as the exefile, a myapp.exe and myapp.prc will be created.

The /W and /H parameters define the default width and height of the
application's window. The value of 0 for either will cause the main window
to appear at a default size which is different on each platform.

If no icon is defined, a default is one used. Icons are scanned first in the
current directory, next in the classpath. You may provide the following files
(WIDTHxHEIGHTxBPP): icon15x9x1.bmp, icon15x9x8.bmp, icon16x16x4.bmp,
icon22x22x1.bmp, icon22x22x8.bmp, icon32x32x1.bmp, icon32x32x4.bmp,
icon32x32x8.bmp, icon48x48x8.bmp. If you specify a prefix (E.g.: AAAA), the
searched files will be AAAAicon22x22x8.bmp, etc.
The 15x9 and 22x22 are for Palm OS and the others for Windows CE.
Note that for Palm OS you must create bitmaps with the web-safe-palette.
A gif with this palette is located under /superwaba/examples
For Windows CE, the palette CANNOT BE THE WEBSAFE one. This happens because in the
Web safe palette, index 0 is white, and WinCE devices expect that index 0 will
be black. A warning will be issued if you use an incorrect palette when
generating the exe files for WinCE. To correct this problem, you may use any
image editor to increase the image to 16bpp or more and then decrease it again
to 256 colors and save the image. Most editors don't use the web safe palette,
what will correct the problem.

A PalmOS PRC creator and PRC name will be assigned based
on the class name and exefile respectively. The exefile must be 30 characters
or less.

The /Z parameter is used to create eight cab files so your application can
easily be installed in all compatible Windows CE platforms. You may pass,
optionally, a .swz file with some global and local libraries used by your
app. For example, if you need to install the TinyLarge.pdb font and also a
custom database, E.g. mydata.pdb, you must copy all files to the current
directory, then create a myapp.swz file with the following contents:

[G]TinyLarge.pdb
[L]mydata.pdb

The [G] denotes a global library (fonts are always global libraries), and the
[L] denotes a local library.
The user will then have two options to start the installation process:
1. Run the created xxx_install.bat file, or
2. If the cab files are available in the internet, the user may launch the
browser from inside the device, connect to the site and choose the appropriate
cab file. The browser will then download and install the file.
The /Z parameter works on in the Windows platform.


Examples:
java Exegen /I myicons.ico /P Scribble scribble
java Exegen /W 160 /H 160 Calc CalcWindow calc
java Exegen /Z SWCalc.swz SWCalc

@@@@@@@@@@@@@@@@@@@@@@@@@ RenameFont instructions @@@@@@@@@@@@@@@@@@@@@@@@@
Usage: RenameFont <fontpath> <oldfontname> <newfontname>
Please dont append the .pdb extension to the font names.
Note that the original files are preserved.



@@@@@@@@@@@@@@@@@@@@@@@@@ Wxgn instructions @@@@@@@@@@@@@@@@@@@@@@@@@
Usage: java Wxgn Warp_commands z Exegen_commands
Note that z is the separator
