javadoc clarifications

2 files changed, 6 insertions, 7 deletions

diff --git a/org.eclipse.text/projection/org/eclipse/jface/text/projection/FragmentUpdater.java b/org.eclipse.text/projection/org/eclipse/jface/text/projection/FragmentUpdater.java
index 7b10221343e..8da7b43a7a1 100644
--- a/org.eclipse.text/projection/org/eclipse/jface/text/projection/FragmentUpdater.java
+++ b/org.eclipse.text/projection/org/eclipse/jface/text/projection/FragmentUpdater.java
@@ -99,13 +99,12 @@ class FragmentUpdater extends DefaultPositionUpdater {
 	}
 
 	/**
-	 * Returns whether this updater considers any position affected by the given
-	 * document event. A position is affected if either the offset or the length
-	 * of the position is modified but the position is not just shifted.
-	 *
+	 * Returns whether this updater considers any position affected by the given document event. A
+	 * position is affected if <code>event</code> {@link Position#overlapsWith(int, int) overlaps}
+	 * with it but not if the position is only shifted.
+	 * 
 	 * @param event the event
-	 * @return <code>true</code> if there is any affected position,
-	 *         <code>false</code> otherwise
+	 * @return <code>true</code> if there is any affected position, <code>false</code> otherwise
 	 */
 	public boolean affectsPositions(DocumentEvent event) {
 		IDocument document= event.getDocument();
diff --git a/org.eclipse.text/projection/org/eclipse/jface/text/projection/ProjectionDocument.java b/org.eclipse.text/projection/org/eclipse/jface/text/projection/ProjectionDocument.java
index 4912eda8073..5565d5b5c58 100644
--- a/org.eclipse.text/projection/org/eclipse/jface/text/projection/ProjectionDocument.java
+++ b/org.eclipse.text/projection/org/eclipse/jface/text/projection/ProjectionDocument.java
@@ -725,7 +725,7 @@ public class ProjectionDocument extends AbstractDocument {
 	}
 
 	/**
-	 * Ensures that when the master event effects this projection document, that the whole region described by the
+	 * Ensures that when the master event affects this projection document, that the whole region described by the
 	 * event is part of this projection document.
 	 *
 	 * @param masterEvent the master document event