Mercurial > hg > truffle

comparison graal/com.oracle.truffle.api/src/com/oracle/truffle/api/instrument/Instrument.java @ 18131:85cec9cab17b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Truffle: format fix.
author Christian Humer <christian.humer@gmail.com>
date Tue, 21 Oct 2014 00:30:06 +0200
parents b4e38f4ca414
children e3c95cbbb50c
comparison
equal deleted inserted replaced
18130:b4e38f4ca414 18131:85cec9cab17b
47 * call {@linkplain InstrumentationNode#notifyProbeChanged(Instrument)} whenever it is modified.</li> 47 * call {@linkplain InstrumentationNode#notifyProbeChanged(Instrument)} whenever it is modified.</li>
48 * <li>Never store a {@link Frame} value in a field.</li> 48 * <li>Never store a {@link Frame} value in a field.</li>
49 * <li>Minimize computation in standard execution paths.</li> 49 * <li>Minimize computation in standard execution paths.</li>
50 * <li>If runtime calls must be made back to a tool, construct the instrument with a callback stored 50 * <li>If runtime calls must be made back to a tool, construct the instrument with a callback stored
51 * in a {@code final} field.</li> 51 * in a {@code final} field.</li>
52 * <li>Tool methods called by the instrument should be annotated as {@link TruffleBoundary} to prevent them 52 * <li>Tool methods called by the instrument should be annotated as {@link TruffleBoundary} to
53 * from being inlined into fast execution paths.</li> 53 * prevent them from being inlined into fast execution paths.</li>
54 * <li>If computation in the execution path is needed, and if performance is important, then the 54 * <li>If computation in the execution path is needed, and if performance is important, then the
55 * computation is best expressed as a guest language AST and evaluated using standard Truffle 55 * computation is best expressed as a guest language AST and evaluated using standard Truffle
56 * mechanisms so that standard Truffle optimizations can be applied.</li> 56 * mechanisms so that standard Truffle optimizations can be applied.</li>
57 * </ol> 57 * </ol>
58 * <p> 58 * <p>