Documentation: Why removing JSR/RET statements.

marchof · marchof · commit 865bd4bd18de · 2012-08-25T10:59:55.000Z
diff --git a/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodSanitizer.java b/org.jacoco.core/src/org/jacoco/core/internal/flow/MethodSanitizer.java
@@ -19,7 +19,9 @@
  * This method visitor fixes two potential issues with Java byte code:
  * 
  * <ul>
- * <li>Remove JSR instructions by inlining subroutines.</li>
+ * <li>Remove JSR/RET instructions by inlining subroutines which are deprecated
+ * since Java 6. The RET statement complicates control flow analysis as the jump
+ * target is not explicitly given.</li>
  * <li>Remove code attributes line number and local variable name if they point
  * to invalid offsets which some tools create. When writing out such invalid
  * labels with ASM class files do not verify any more.</li>
