Mercurial > hg > truffle
changeset 17440:935de03661c1
Truffle: clearer comment in AssumedValue.
author | Chris Seaton <chris.seaton@oracle.com> |
---|---|
date | Tue, 14 Oct 2014 15:10:17 +0100 |
parents | e9c8742148c1 |
children | 3a586c78a807 |
files | graal/com.oracle.truffle.api/src/com/oracle/truffle/api/utilities/AssumedValue.java |
diffstat | 1 files changed, 6 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- a/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/utilities/AssumedValue.java Tue Oct 14 15:06:49 2014 +0100 +++ b/graal/com.oracle.truffle.api/src/com/oracle/truffle/api/utilities/AssumedValue.java Tue Oct 14 15:10:17 2014 +0100 @@ -29,9 +29,12 @@ import com.oracle.truffle.api.nodes.*; /** - * A {@link CompilationFinal} value combined with an {@link Assumption} to notify when it changes. - * Note that you should be careful that modifications to this value do not cause deoptimization - * loops. This could be by using a value that is monotonic. + * A value that the compiler can assume is constant, but can be changed by invalidation. + * <p> + * Compiled code that uses the value will be invalidated each time the value changes, so you should + * take care to only change values infrequently, or to monitor the number of times the value has + * changed and at some point to replace the value with something more generic so that it does not + * have to be changed and code does not have to keep being recompiled. */ public class AssumedValue<T> {