# HG changeset patch
# User Gilles Duboscq <duboscq@ssw.jku.at>
# Date 1377436737 -7200
# Node ID 2c3ca4b719655aac2f2dfe0008428bc243a5f01e
# Parent  7a775592258f79ceba8e992470b70aa2fed3466c
Add more javadoc to ConvertDeoptimizeToGuardPhase

diff -r 7a775592258f -r 2c3ca4b71965 graal/com.oracle.graal.phases.common/src/com/oracle/graal/phases/common/ConvertDeoptimizeToGuardPhase.java
--- a/graal/com.oracle.graal.phases.common/src/com/oracle/graal/phases/common/ConvertDeoptimizeToGuardPhase.java	Sun Aug 25 15:15:23 2013 +0200
+++ b/graal/com.oracle.graal.phases.common/src/com/oracle/graal/phases/common/ConvertDeoptimizeToGuardPhase.java	Sun Aug 25 15:18:57 2013 +0200
@@ -34,6 +34,10 @@
  * This phase will find branches which always end with a {@link DeoptimizeNode} and replace their
  * {@link ControlSplitNode ControlSplitNodes} with {@link FixedGuardNode FixedGuardNodes}.
  * 
+ * This is useful because {@link FixedGuardNode FixedGuardNodes FixedGuardNodess} will be lowered to
+ * {@link GuardNode GuardNodes} which can later be optimized more aggressively than control-flow
+ * constructs.
+ * 
  * This is currently only done for branches that start from a {@link IfNode}. If it encounters a
  * branch starting at an other kind of {@link ControlSplitNode}, it will only bring the
  * {@link DeoptimizeNode} as close to the {@link ControlSplitNode} as possible.