Mercurial > hg > graal-jvmci-8
diff graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/impl/ProbeManager.java @ 16873:3ad18f453679
Truffle/Instrumentation: Javadoc
author | Michael Van De Vanter <michael.van.de.vanter@oracle.com> |
---|---|
date | Wed, 20 Aug 2014 15:14:30 -0700 |
parents | 1051d6e4b61b |
children | c88ab4f1f04a |
line wrap: on
line diff
--- a/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/impl/ProbeManager.java Wed Aug 20 16:50:25 2014 +0200 +++ b/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/impl/ProbeManager.java Wed Aug 20 15:14:30 2014 -0700 @@ -43,10 +43,6 @@ /** * Called when a {@link #tagTrap} is activated in a Probe. */ - /** - * The callback to be triggered by the {@link #tagTrap}. - * - */ private final ProbeCallback probeCallback; /** @@ -72,9 +68,7 @@ } /** - * Add a {@link ProbeListener} to receive events. - * - * @param listener The listener to be added. + * Adds a {@link ProbeListener} to receive events. */ public void addProbeListener(ProbeListener listener) { assert listener != null; @@ -82,9 +76,7 @@ } /** - * Remove a {@link ProbeListener}. If no matching probe listener is found, nothing happens. - * - * @param removeListener + * Removes a {@link ProbeListener}. Ignored if listener not found. */ public void removeProbeListener(ProbeListener removeListener) { final List<ProbeListener> listeners = new ArrayList<>(probeListeners); @@ -97,10 +89,7 @@ /** * Creates a new {@link Probe} associated with a {@link SourceSection} of code corresponding to - * a Trufle AST node. - * - * @param source The source section to associate with this probe. - * @return The probe that was created. + * a Truffle AST node. */ public Probe createProbe(SourceSection source) { assert source != null; @@ -119,7 +108,7 @@ * Returns the subset of all {@link Probe}s holding a particular {@link SyntaxTag}, or the whole * collection if the specified tag is {@code null}. * - * @return An iterable collection of probes containing the given tag. + * @return A collection of probes containing the given tag. */ public Collection<Probe> findProbesTaggedAs(SyntaxTag tag) { final List<Probe> probes = new ArrayList<>(); @@ -132,8 +121,10 @@ } /** - * Calls {@link ProbeImpl#setTrap(SyntaxTagTrap)} for all probes with the given - * {@link SyntaxTag} . There can only be one tag trap set at a time. + * Sets the current "tag trap", which will cause a callback to be triggered whenever execution + * reaches a Probe (existing or subsequently created) with the specified tag. There can only be + * one tag trap set at a time. + * <p> * * @param tagTrap The {@link SyntaxTagTrap} to set. * @throws IllegalStateException if a trap is currently set.