diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionConverter.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionConverter.java
index bb19a657eb3..da07eec24b9 100644
--- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionConverter.java
+++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionConverter.java
@@ -21,13 +21,15 @@ import org.eclipse.jface.text.Position;
  * 
  * As long as the underlying text of the character range has not been modified the
  * converted range will have the same underlying text. Insertions at the beginning
- * or the end of the text do not added to the converted range. 
+ * or the end of the text are not added to the converted range. 
  * 
  * An insertion inside the underlying text will increase the length of the converted
  * range, a deletion of one of the characters will decrease it.
  * 
  * An deletion followed by an insertion without saving the file inbetween, will cancel
- * the deletion as much as possible.
+ * the deletion as far as possible.
+ * 
+ * <p> This interface is not intended to be implemented by clients. </p>
  */
 
 public interface IPositionConverter {
@@ -46,7 +48,6 @@ public interface IPositionConverter {
      * @param historicPosition a range as found in the version of the file for which
      * the converter was obtained.
      * @return a range suitable for the current text buffer of the file.
-     * 
      */
     Position historicToActual(Position historicPosition);
 }
diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionTrackerManager.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionTrackerManager.java
index d186416a437..80a9da311b8 100644
--- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionTrackerManager.java
+++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/core/IPositionTrackerManager.java
@@ -16,11 +16,14 @@ import org.eclipse.core.runtime.IPath;
 
 /**
  * An interface to manage the position tracking. It allows for mapping character 
- * offsets from a file previously stored on disk to the current offset.
+ * offsets from a file previously stored on disk to the offset in the current document
+ * for the file.
+ * 
+ * <p> This interface is not intended to be implemented by clients. </p>
  */
 public interface IPositionTrackerManager {
     /**
-     * Returns the position tracker suitable for mapping character offsets of the
+     * Returns the position converter suitable for mapping character offsets of the
      * given file/timestamp to the current version of it.
      * 
      * @param file a file for which the position adapter is requested.