# HG changeset patch
# User Chris Seaton <chris.seaton@oracle.com>
# Date 1413295817 -3600
# Node ID 935de03661c1a85e05538dbd9b339d8f961b464e
# Parent  e9c8742148c16090c6820bc8522f202e464f57ae
Truffle: clearer comment in AssumedValue.

diff -r e9c8742148c1 -r 935de03661c1 graal/com.oracle.truffle.api/src/com/oracle/truffle/api/utilities/AssumedValue.java
--- 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> {