WAPIDE 1.0 README
Copyright (C) 2003 Mark Busman

WAPIDE - a java based Integrated Development Environment

this code is provided in the hope that it will be 
useful, with no warranties, express or implied.
code is provided subject to the Gnu General Public
License. see the file COPYING for details.


BUILDING

Its a simple build.
To compile type the following in a console:
javac -sourcepath (path to src directory) -d path to classes output directory) \path\WAPIDE\src\wapide\*.java

Example of how I compiled under a windows system
d:\jdk1.3\bin\javac -sourcepath \e:\WAPIDE\src -d e:\WAPIDE\classes e:\WAPIDE\src\wapide\*.java

You may get a deprecation warning, just ignore it.

Once you have all the classes compiled, copy all supporting files in the src directories
into their respective directories in the classes folder.  The text files and images files needed
by the program do not get copied over automatically.


RUNNING 

Once all the neccessary class files and their supporting image and text files have been copied into their
appropriate directories inside the classes directory, if doing a build with the source code, modify the bat 
file (for windows) or modify the Linux executable wapide file.  Modify either of these files to point to the 
location of the java executables on your system, and modify the -classpath directive so that the classes 
directory points to the classes directory on your system where the WAPIDE classes reside.

There are several ways of doing this:

set allclasspath="c:\jdk1.3.1\bin" 
c:\jdk1.3.1\bin\java -classpath "%allclasspath%:classes:classes\wapide:classes\sim:classes\Designer:classes\wbmp" wapide.WAPIDE 

C:\JDK1.3\bin\javaw -classpath "C:\My Documents\Programming\WAPIDE\classes"  wapide.WAPIDE

/home/cougar/JBuilder7/jdk1.3.1/bin/java -classpath "classes" wapide.WAPIDE

How you modify the classpath depends on how you call up the program.  If you plan to call up the program directly from the folder that contains the classes directory, the last option will work fine.  If you plan to call it up from a different directory you will need to experiment with the first two options.

After modifying the classpath, be sure to change to the directory that contains the program's classes directory.  Run the
batch file and if you get an error message try modifying the classpath switch until the program runs.


THE WBMP SAMPLES
The samples provided in this release where created by my
sister, Monica Busman.  I wish to thank her for her efforts
in making some nice sample images for this project.


BUGS

There are bound to be plenty of bugs, todos, and the like.

There where a lot of troubles during development with the StateInVariantError which
Java throws when two components try to update the screen at the same time.  Prior to the
release of this version that problem seems to have been resolved, but it is possible it may
still reoccur, and there is no way of catching it when it does occur.  This means having to
shutdown the program and restart it in the event that the StateInVariantError does occur.  I am 
trying to find a workaround for this problem which occurs a lot in the Graphical Editor portion
of the program, the portion that allows for graphical editing of WML cards and decks.
  
For other bug reports plesse send an e-mail to cougar@skyinet.net with "WAPIDE BUG" somewhere in the title of the
message.
 

Mark Busman
cougar@skyinet.net

Feb 20, 2003