comparison graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/ASTInstrumentListener.java @ 20891:0f3d81231ecb

Truffle/Instrumentation: Javadoc
author Michael Van De Vanter <michael.van.de.vanter@oracle.com>
date Fri, 10 Apr 2015 17:56:10 -0700
parents 37912559d662
children 73b1844b5b14
comparison
equal deleted inserted replaced
20890:37912559d662 20891:0f3d81231ecb
30 30
31 /** 31 /**
32 * A receiver of Truffle execution events that can act on behalf of an external client. 32 * A receiver of Truffle execution events that can act on behalf of an external client.
33 * <p> 33 * <p>
34 * The {@link Probe} argument provides access to the {@link SourceSection} associated with the 34 * The {@link Probe} argument provides access to the {@link SourceSection} associated with the
35 * event, as well as any {@link SyntaxTag}s that have been applied at that AST location. 35 * event, as well as any {@link SyntaxTag}s that have been applied at that AST node.
36 * <p> 36 * <p>
37 * This listener is designed for clients that also require access to the AST execution state at the 37 * This listener is designed for clients that also require access to the AST execution state at the
38 * time of the event. Clients that do not require access to the AST execution state should use the 38 * time of the event. Clients that do not require access to the AST execution state should use the
39 * simpler {@link InstrumentListener}. 39 * simpler {@link InstrumentListener}.
40 * <p> 40 * <p>
41 * Clients are free, of course, to record additional information in the listener implementation that 41 * Clients are free, of course, to record additional information in the listener implementation that
42 * carries additional information about the context and reason for the particular {@link Instrument} 42 * carries additional information about the context and reason for the particular {@link Instrument}
43 * that is to be created. 43 * that is to be created from the listener.
44 */ 44 */
45 public interface ASTInstrumentListener { 45 public interface ASTInstrumentListener {
46 46
47 /** 47 /**
48 * Receive notification that an AST node's execute method is about to be called. 48 * Receive notification that an AST node's execute method is about to be called.