+ JPDA API represents JDI functionality. + Since JDI interfaces evolve from one version to another, it's + necessary to declare that interfaces in + org.netbeans.api.debugger.jpda package should not be implemented, + since new methods can be added to these interfaces at any time + to keep up with the JDI functionality. +
++ Also JPDABreakpointEvent and JPDABreakpointListener are moved to + newly created org.netbeans.api.debugger.jpda.event package. +
++ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.* * @author Jan Jancura */ Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Field.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Field.java,v retrieving revision 1.4 diff -u -r1.4 Field.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Field.java 7 May 2004 14:14:19 -0000 1.4 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Field.java 12 Aug 2005 09:00:42 -0000 @@ -19,6 +19,11 @@ * interface, if the represented field contains not primitive value (object * value). * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.+ * * @see ObjectVariable * @author Jan Jancura */ Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDABreakpoint.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDABreakpoint.java,v retrieving revision 1.8 diff -u -r1.8 JPDABreakpoint.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDABreakpoint.java 30 Sep 2004 11:38:59 -0000 1.8 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDABreakpoint.java 12 Aug 2005 09:00:42 -0000 @@ -19,6 +19,8 @@ import java.util.Iterator; import org.netbeans.api.debugger.Breakpoint; +import org.netbeans.api.debugger.jpda.event.JPDABreakpointEvent; +import org.netbeans.api.debugger.jpda.event.JPDABreakpointListener; /** * Abstract definition of JPDA breakpoint. cvs server: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDABreakpointEvent.java was removed, no comparison available cvs server: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDABreakpointListener.java was removed, no comparison available Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDADebugger.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDADebugger.java,v retrieving revision 1.17 diff -u -r1.17 JPDADebugger.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDADebugger.java 2 Aug 2005 15:55:15 -0000 1.17 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDADebugger.java 12 Aug 2005 09:00:42 -0000 @@ -32,6 +32,7 @@ import org.netbeans.api.debugger.DebuggerManager; import org.netbeans.api.debugger.jpda.InvalidExpressionException; import org.netbeans.api.debugger.jpda.Variable; +import org.netbeans.api.debugger.jpda.event.JPDABreakpointEvent; /** Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThread.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThread.java,v retrieving revision 1.5 diff -u -r1.5 JPDAThread.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThread.java 7 Jan 2005 09:33:20 -0000 1.5 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThread.java 12 Aug 2005 09:00:42 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -21,6 +21,11 @@ /** * Represents one Java thread in debugged process. * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.+ * * @author Jan Jancura */ public interface JPDAThread { Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThreadGroup.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThreadGroup.java,v retrieving revision 1.2 diff -u -r1.2 JPDAThreadGroup.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThreadGroup.java 31 Mar 2004 07:17:41 -0000 1.2 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAThreadGroup.java 12 Aug 2005 09:00:43 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -17,6 +17,11 @@ /** * Represents one Java thread group in debugged process. * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.+ * * @author Jan Jancura */ public interface JPDAThreadGroup { Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAWatch.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAWatch.java,v retrieving revision 1.6 diff -u -r1.6 JPDAWatch.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAWatch.java 17 Jun 2004 13:02:39 -0000 1.6 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/JPDAWatch.java 12 Aug 2005 09:00:43 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -17,6 +17,11 @@ /** * Represents watch in JPDA debugger. + * + *
+ * It's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.* * @author Jan Jancura */ Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/LocalVariable.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/LocalVariable.java,v retrieving revision 1.4 diff -u -r1.4 LocalVariable.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/LocalVariable.java 10 May 2004 08:44:47 -0000 1.4 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/LocalVariable.java 12 Aug 2005 09:00:43 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -18,6 +18,11 @@ * Represents one local. This interface is extended by {@link ObjectVariable} * interface, if the represented local contains not primitive value (object * value). + * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.* * @see ObjectVariable * @author Jan Jancura Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/ObjectVariable.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/ObjectVariable.java,v retrieving revision 1.6 diff -u -r1.6 ObjectVariable.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/ObjectVariable.java 3 Jun 2005 13:38:07 -0000 1.6 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/ObjectVariable.java 12 Aug 2005 09:00:43 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -18,6 +18,11 @@ * Represents instance of some object in debugged JVM. This interface can * be optionally inplemented by a implementation of {@link LocalVariable} or * {@link Field} interfaces. + * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.* * @see LocalVariable * @see Field Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/SmartSteppingFilter.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/SmartSteppingFilter.java,v retrieving revision 1.3 diff -u -r1.3 SmartSteppingFilter.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/SmartSteppingFilter.java 15 May 2004 21:32:01 -0000 1.3 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/SmartSteppingFilter.java 12 Aug 2005 09:00:43 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -19,6 +19,11 @@ /** * Defines list of class exclusion filters to be used to filter stepping * in debugged session. + * + *
+ * It's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.* * @author Jan Jancura */ Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Super.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Super.java,v retrieving revision 1.2 diff -u -r1.2 Super.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Super.java 31 Mar 2004 07:17:44 -0000 1.2 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Super.java 12 Aug 2005 09:00:43 -0000 @@ -17,6 +17,11 @@ /** * Represents super class of some object and its value. * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.+ * * @see ObjectVariable#getSuper * * @author Jan Jancura Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/This.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/This.java,v retrieving revision 1.2 diff -u -r1.2 This.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/This.java 31 Mar 2004 07:17:45 -0000 1.2 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/This.java 12 Aug 2005 09:00:43 -0000 @@ -17,6 +17,11 @@ /** * Represents "this" value for call stack frame. * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.+ * * @see CallStackFrame#getThisVariable * * @author Jan Jancura Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Variable.java =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Variable.java,v retrieving revision 1.2 diff -u -r1.2 Variable.java --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Variable.java 31 Mar 2004 07:17:45 -0000 1.2 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/Variable.java 12 Aug 2005 09:00:43 -0000 @@ -7,7 +7,7 @@ * http://www.sun.com/ * * The Original Code is NetBeans. The Initial Developer of the Original - * Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + * Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun * Microsystems, Inc. All Rights Reserved. */ @@ -16,6 +16,11 @@ /** * Represents some variable in debugged JVM. + * + *
+ * Since JDI interfaces evolve from one version to another, it's strongly recommended + * not to implement this interface in client code. New methods can be added to + * this interface at any time to keep up with the JDI functionality.* * @see LocalVariable * @see Field Index: debuggerjpda/api/src/org/netbeans/api/debugger/jpda/package.html =================================================================== RCS file: /cvs/debuggerjpda/api/src/org/netbeans/api/debugger/jpda/package.html,v retrieving revision 1.2 diff -u -r1.2 package.html --- debuggerjpda/api/src/org/netbeans/api/debugger/jpda/package.html 31 Mar 2004 07:17:46 -0000 1.2 +++ debuggerjpda/api/src/org/netbeans/api/debugger/jpda/package.html 12 Aug 2005 09:00:43 -0000 @@ -17,15 +17,19 @@ -- http://www.sun.com/ -- -- The Original Code is NetBeans. The Initial Developer of the Original - -- Code is Sun Microsystems, Inc. Portions Copyright 1997-2000 Sun + -- Code is Sun Microsystems, Inc. Portions Copyright 1997-2005 Sun -- Microsystems, Inc. All Rights Reserved. --> -JPDA Debugger APIs. -
+Since JDI interfaces evolve from one version to another, it's strongly recommended +not to implement any interface in this package. New methods can be added to +these interfaces at any time to keep up with the JDI functionality.