Bug 88838 [Undo] - API cleanup - remove IContextConsultingOperationApprover
Early on this was involved in scenarios where editors examined other operations. This is no longer used. Operation approvers generally apply to all contexts and are installed at the OperationHistory level. Until there is a concrete need for this API it should be removed. It is gratuitous at this point.
bundles/org.eclipse.core.commands/src/org/eclipse/core/commands/operations/IContextOperationApprover.java
import org.eclipse.core.runtime.IAdaptable;
import org.eclipse.core.runtime.IStatus;
/**
 * <p>
 * IContextOperationApprover defines an interface for approving the undo or redo
 * of a particular operation within an operation history given a particular
 * operation context. Operations that are candidates for undo or redo have
 * already been validated against their current state.
 * </p>
 * <p>
 * By the time an IContextOperationApprover is consulted, the undo has already
 * been requested. Approvers should return an IStatus with severity
 * <code>OK</code> if the operation should proceed, and any other status if it
 * should not. The status should further describe the rejection. When an
 * operation is rejected, it is expected that the object rejecting the operation
 * has already consulted the user if necessary or otherwise provided any
 * necessary information to the user about the rejection.
 * </p>
 * <p>
 * Note: This class/interface is part of a new API under development. It has
 * been added to builds so that clients can start using the new features.
 * However, it may change significantly before reaching stability. It is being
 * made available at this early stage to solicit feedback with the understanding
 * that any code that uses this API may be broken as the API evolves.
 * </p>
 * 
 * @since 3.1
 * @experimental
 */
public interface IContextOperationApprover {