# HG changeset patch
# User Doug Simon <doug.simon@oracle.com>
# Date 1355840340 -3600
# Node ID a990b07c399d60da81e250449c67133b6af65132
# Parent  169bbc849ee90aedbf9de443b980ddcdd058c739
added more documentation to DeoptimizationAction

diff -r 169bbc849ee9 -r a990b07c399d graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/DeoptimizationAction.java
--- a/graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/DeoptimizationAction.java	Tue Dec 18 13:13:09 2012 +0100
+++ b/graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/DeoptimizationAction.java	Tue Dec 18 15:19:00 2012 +0100
@@ -28,6 +28,9 @@
 public enum DeoptimizationAction {
     /**
      * Do not invalidate the machine code.
+     * This is typically used when deoptimizing at a point where it's highly likely
+     * nothing will change the likelihood of the deoptimization happening again.
+     * For example, a compiled array allocation where the size is negative.
      */
     None,
 
@@ -43,6 +46,9 @@
 
     /**
      * Invalidate the machine code and immediately schedule a recompilation.
+     * This is typically used when deoptimizing to resolve an unresolved symbol in
+     * which case extra profiling is not required to determine that the deoptimization
+     * will not re-occur.
      */
     InvalidateRecompile,