Mercurial > hg > graal-compiler
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. |