                      VisualAge(R) for Java(TM)
                             Version 3.0

                               Examples

                            RELEASE NOTES


Table of Contents
-----------------

1.0 Introduction
2.0 Limitations and known problems
    2.1 Visual Composition Editor examples
        2.1.1 com.ibm.ivj.examples.vc.beandemo
    2.2 Sun BDK Examples
        2.2.1 Adding Beans to Sun's BeanBox Demo
        2.2.2 BridgeTester Bean
    2.3 Sun JDK Examples
        2.3.1 Sun JDK Animator
        2.3.2 Sun JDK Clock
        2.3.3 Sun JDK DrawTest
        2.3.4 Sun JDK SymbolTest

1.0 Introduction
----------------

VisualAge for Java, Version 3.0 contains example applications and
applets you can use to start exploring VisualAge for Java.

The examples fall into six categories:

   Visual Composition Editor Examples
   Getting Started Examples
   Towers of Hanoi
   Sun BDK Examples
   Sun JDK Examples
   AWT Examples

For information about adding the examples to your workspace and 
running the examples, please consult the online documentation.

2.0 Limitations and known problems
----------------------------------

2.1 Visual Composition Editor Examples

2.1.1 com.ibm.ivj.examples.vc.beandemo

This example uses beans contained in the Sun BDK Examples project.
This means that you have to load the project Sun BDK Examples 
before you can run this example.

You can load the Sun BDK Examples project before, at the same 
time or after you load the IBM Java Examples project.

If you loaded the IBM Java Examples project before loading the 
Sun BDK Examples project you would have noticed several compile 
errors that would show up in the "Unresolved Problems" tab of the
Workbench. When you load the Sun BDK Examples these errors are 
automatically corrected.

2.2 Sun BDK Examples

2.2.1  Adding Beans to Sun's BeanBox Demo

If you want to add beans to the Sun BeanBox you must copy the 
*.jar files for the beans to the directory:

   \<ibmvjava>\ide\project_resources\jars

Where <ibmvjava> is the directory where you installed VisualAge
for Java.  

You must also import the *.jar files into IBM VisualAge for Java
before trying to run the new beans from the Sun BeanBox.  Detailed
instructions for importing *.jar can be found in the IBM VisualAge
for Java documentation.

2.2.2 BridgeTester Bean

We do not ship the BridgeTester Bean that ships with Sun BDK 1.0.
This bean exposes a bug in Sun's java.beans package.

2.3 Sun JDK Examples

2.3.1 Sun JDK Animator

If you select the restart option from the applet viewer menu 
while animator is running errors will be displayed on the Console. 
The same behavior is present when this example is run under Sun 
JDK 1.1.7A.

Due to problems with the way the Animator example is written you may
experience a deadlock condition if you run a large number of
Animators. The Sun JDK 1.1.7A experiences the same problem.

2.3.2 Sun JDK Clock

The graphical time display will show the current system time but 
the textual time may be incorrect.

2.3.3 Sun JDK DrawTest

If you are running IBM VisualAge for Java in Windows 95/98 or 
Windows NT and are using 256 colors then the fourth radio 
button from the left will not draw with the displayed color.
It will draw in gray. This is a known problem that has to
do with the way Windows allocates colors. The problem 
does not appear if you have a higher color resolution
or if you are running VisualAge for Java under OS/2.

2.3.4 Sun JDK SymbolTest

The symbols will not be displayed. Instead you will see 
the escape codes for the symbols. This is a known problem.



