diff graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/Probe.java @ 15605:bb9473723904

Truffle/Instrumentation: - Merge instrumentation support into the general execution context; remove separate Instrumentation interface and implementation - Generalize the ?tagging? mechanism for extensibility: the enum PhylumTag is now an interface, and the standard tags moved to the new enum StandardTag - A new ?trap? mechanism interrupts program execution at any probed node holding a specified PhylumTag; this replaces some other special-purpose code. - Refine several interface by factoring out callback methods and simplifying collaboration among key implementation classes.
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Mon, 12 May 2014 20:17:25 -0700
parents 0c6d8a08e31b
children 8c34e2cc4add
line wrap: on
line diff
--- a/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/Probe.java	Fri May 02 16:12:07 2014 -0700
+++ b/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/Probe.java	Mon May 12 20:17:25 2014 -0700
@@ -48,7 +48,11 @@
  * removed, but some instruments may change their internal state in such a way that the assumption
  * should also be invalidated.
  * <p>
- * <strong>Disclaimer:</strong> experimental interface under development.
+ * <strong>Disclaimer:</strong> experimental interface under development. In particular, the
+ * <em>notify</em> methods must be migrated to another interface.
+ *
+ * @see Instrument
+ * @see Wrapper
  */
 public interface Probe extends PhylumTagged {
 
@@ -73,17 +77,7 @@
      */
     void removeInstrument(Instrument oldInstrument);
 
-    /**
-     * Change <em>stepping mode</em>, which is used in association with nodes tagged as
-     * {@linkplain PhylumTag#STATEMENT statements}.
-     */
-    void setStepping(boolean stepping);
-
-    /**
-     * Value of <em>stepping mode</em>, which is used in association with nodes tagged as
-     * {@linkplain PhylumTag#STATEMENT statements}.
-     */
-    boolean isStepping();
+    // TODO (mlvdv) migrate the remaining methods to another interface.
 
     /**
      * @see ExecutionEvents#enter(Node, VirtualFrame)