--- old/src/java.xml/share/classes/com/sun/org/apache/bcel/internal/generic/InstructionTargeter.java 2017-08-08 16:05:41.110796084 -0700 +++ new/src/java.xml/share/classes/com/sun/org/apache/bcel/internal/generic/InstructionTargeter.java 2017-08-08 16:05:41.026791878 -0700 @@ -21,7 +21,6 @@ package com.sun.org.apache.bcel.internal.generic; - /** * Denote that a class targets InstructionHandles within an InstructionList. Namely * the following implementers: @@ -29,9 +28,21 @@ * @see BranchHandle * @see LocalVariableGen * @see CodeExceptionGen - * @author M. Dahm + * @version $Id: InstructionTargeter.java 1747278 2016-06-07 17:28:43Z britter $ */ public interface InstructionTargeter { - public boolean containsTarget(InstructionHandle ih); - public void updateTarget(InstructionHandle old_ih, InstructionHandle new_ih); + + /** + * Checks whether this targeter targets the specified instruction handle. + */ + boolean containsTarget(InstructionHandle ih); + + /** + * Replaces the target of this targeter from this old handle to the new handle. + * + * @param old_ih the old handle + * @param new_ih the new handle + * @throws ClassGenException if old_ih is not targeted by this object + */ + void updateTarget(InstructionHandle old_ih, InstructionHandle new_ih) throws ClassGenException; }