@@ -433,7 +433,7 @@ protected void contentChanged(final IContentChangeNotifier changed) {
433433 * @deprecated Clients should override
434434 * {@link #preDiffHook(IStructureComparator, IStructureComparator, IStructureComparator, IProgressMonitor)}
435435 */
436- @ Deprecated
436+ @ Deprecated ( forRemoval = true , since = "2025-12" )
437437 protected void preDiffHook (IStructureComparator ancestor , IStructureComparator left , IStructureComparator right ) {
438438 // we do nothing here
439439 }
@@ -589,25 +589,26 @@ private void handleFailedRefresh(final String message) {
589589 * {@link #postDiffHook(Differencer, IDiffContainer, IProgressMonitor)}
590590 * instead
591591 */
592- @ Deprecated
592+ @ Deprecated ( forRemoval = true , since = "2025-12" )
593593 protected void postDiffHook (Differencer differencer , IDiffContainer root ) {
594594 // we do nothing here
595595 }
596596
597597 /**
598- * This method is called from within {@link #diff(IProgressMonitor)} after
599- * the difference tree has been built. This method may be called from a
600- * background (non-UI) thread).
598+ * This method is called from within {@link #diff(IProgressMonitor)} after the
599+ * difference tree has been built. This method may be called from a background
600+ * (non-UI) thread).
601601 * <p>
602602 * For backwards compatibility, this default implementation calls
603603 * {@link #postDiffHook(Differencer, IDiffContainer)} from the UI thread.
604604 * Clients should override this method even if they don't perform post
605- * processing to avoid the call to the UI thread.
605+ * processing to avoid the call to the UI thread. This default implementation
606+ * does nothing.
606607 *
607608 * @param differencer the differencer used to perform the differencing
608- * @param root the non-<code>null</code> root node of the difference tree
609- * @param monitor a progress monitor or <code>null</code> if progress is
610- * not required
609+ * @param root the non-<code>null</code> root node of the difference tree
610+ * @param monitor a progress monitor or <code>null</code> if progress is not
611+ * required
611612 * @since 3.3
612613 */
613614 protected void postDiffHook (final Differencer differencer , final IDiffContainer root , IProgressMonitor monitor ) {
0 commit comments