JSWAT README
======================================================================
$Id: README.txt,v 1.6 2002/04/05 20:17:45 nfiedler Exp $

WHAT IS IT?
----------------------------------------------------------------------
JSwat is a graphical Java debugger front-end written in Java, using the
Java 2 Platform. This program is under constant development, though it
can be considered fairly stable and somewhat feature complete.


REQUIREMENTS
----------------------------------------------------------------------
JSwat requires the Java Platform Debugger Architecture (JPDA), also
known as Jbug or JDI, which provides the debugger back-end functionality.
The JPDA is available separately from the JavaSoft web site:

  http://java.sun.com/products/jpda/

JPDA is included in all JDKs 1.3 and later in the lib/tools.jar file.
It also comes in the J2SE 1.2.2 (and above) for Linux. See the notes
on the Java Virtual Machines below for more information on using JSwat
with JDK 1.3 and later.


INSTALLING JSWAT
----------------------------------------------------------------------
The documentation for JSwat is available on the website as a separate
downloadable on the downloads page. It is also available at:

  http://www.bluemarsh.com/java/jswat/docs/


VIRTUAL MACHINES AND JSWAT
----------------------------------------------------------------------
HotSpot
-------
Older versions of the HotSpot VM had problems with thread status and
setting breakpoints. The newer versions found in JDK/JRE 1.3 and later
seem to have solved these problems. If you are running an older
HotSpot VM, you may want to run the Classic VM instead. To disable the
HotSpot VM, simply modify the <java_home>/jre/lib/jvm.cfg file,
putting the "-classic" line before the "-hotspot" line.

JDK 1.2.2
---------
Stepping is handled differently in 1.2.2 under Win32 versus 1.2.1 and
so there are problems with viewing local variables while stepping.
Thus you may want to disable the refresh code in the locals panel
source file.  Alternatively it would be a good idea to upgrade to
JDK 1.3 or later.

JDK 1.3, 1.4
------------
The Java Platform Debugger Architecture (JPDA) is a part of JDK 1.3 and
is found in the <java_home>/lib/tools.jar file.
