Index: trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/taskequality/GUIEventTaskComparisonRule.java
===================================================================
--- trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/taskequality/GUIEventTaskComparisonRule.java	(revision 1146)
+++ trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/taskequality/GUIEventTaskComparisonRule.java	(revision 1154)
@@ -133,10 +133,17 @@
      * returns lexical equality.
      * </p>
-     *
-     * @param interaction1 the first interaction to compare
-     * @param interaction2 the second interaction to compare
-     * @param eventTarget  the event target on which the interactions happened (used within
-     *                     special comparisons like mouse clicks on buttons, where the coordinates
-     *                     can be ignored)
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level can be at most as
+     * concrete as the provided one. If the provided one is null, it is expected to be lexical
+     * equality.
+     * </p>
+     *
+     * @param interaction1  the first interaction to compare
+     * @param interaction2  the second interaction to compare
+     * @param eventTarget   the event target on which the interactions happened (used within
+     *                      special comparisons like mouse clicks on buttons, where the coordinates
+     *                      can be ignored)
+     * @param equalityLevel the equality level to be checked for
      * 
      * @return as described
@@ -192,12 +199,20 @@
     /**
      * <p>
-     * TODO: comment
-     * </p>
-     *
-     * @param interaction1
-     * @param interaction2
-     * @param eventTarget
-     * @param level
-     * @return
+     * compares two key interactions. If both are of the same type and if both have the
+     * same key, they are lexically equal. If both are only of the same type, they are
+     * semantically equal. Otherwise, they are unequal.
+     * </p>
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level is as concrete as
+     * the provided one. It may be more concrete if there is no difference regarding the
+     * comparison on the levels.
+     * </p>
+     *
+     * @param interaction1  the first key interaction
+     * @param interaction2  the second key interaction
+     * @param equalityLevel the equality level to be checked for
+     * 
+     * @return as described
      */
     private TaskEquality compareKeyInteractions(KeyInteraction interaction1,
@@ -227,7 +242,14 @@
      * coordinates, they are lexically equal. Otherwise, they are semantically equal.
      * </p>
-     *
-     * @param interaction1 the first mouse drag and drop to compare
-     * @param interaction2 the second mouse drag and drop to compare
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level is as concrete as
+     * the provided one. It may be more concrete if there is no difference regarding the
+     * comparison on the levels.
+     * </p>
+     *
+     * @param interaction1  the first mouse drag and drop to compare
+     * @param interaction2  the second mouse drag and drop to compare
+     * @param equalityLevel the equality level to be checked for
      * 
      * @return as described
@@ -267,10 +289,17 @@
      * lexically equal.
      * </p>
-     *
-     * @param interaction1 the first mouse button interaction to compare
-     * @param interaction2 the second mouse button interaction to compare
-     * @param eventTarget  the event target on which the interactions happened (used within
-     *                     special comparisons like mouse clicks on buttons, where the coordinates
-     *                     can be ignored)
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level is as concrete as
+     * the provided one. It may be more concrete if there is no difference regarding the
+     * comparison on the levels.
+     * </p>
+     *
+     * @param interaction1  the first mouse button interaction to compare
+     * @param interaction2  the second mouse button interaction to compare
+     * @param eventTarget   the event target on which the interactions happened (used within
+     *                      special comparisons like mouse clicks on buttons, where the coordinates
+     *                      can be ignored)
+     * @param equalityLevel the equality level to be checked for
      * 
      * @return as described
@@ -334,10 +363,17 @@
      * lexically equal.
      * </p>
-     *
-     * @param interaction1 the first mouse button interaction to compare
-     * @param interaction2 the second mouse button interaction to compare
-     * @param eventTarget  the event target on which the interactions happened (used within
-     *                     special comparisons like mouse clicks on buttons, where the coordinates
-     *                     can be ignored)
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level is as concrete as
+     * the provided one. It may be more concrete if there is no difference regarding the
+     * comparison on the levels.
+     * </p>
+     *
+     * @param interaction1  the first mouse button interaction to compare
+     * @param interaction2  the second mouse button interaction to compare
+     * @param eventTarget   the event target on which the interactions happened (used within
+     *                      special comparisons like mouse clicks on buttons, where the coordinates
+     *                      can be ignored)
+     * @param equalityLevel the equality level to be checked for
      * 
      * @return as described
@@ -368,7 +404,14 @@
      * (the equality of the event targets is checked beforehand).
      * </p>
-     *
-     * @param interaction1 the first text input to compare
-     * @param interaction2 the second text input to compare
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level is as concrete as
+     * the provided one. It may be more concrete if there is no difference regarding the
+     * comparison on the levels.
+     * </p>
+     *
+     * @param interaction1  the first text input to compare
+     * @param interaction2  the second text input to compare
+     * @param equalityLevel the equality level to be checked for
      * 
      * @return as described
@@ -402,7 +445,14 @@
      * (the equality of the event targets is checked beforehand).
      * </p>
-     *
-     * @param interaction1 the first value selection to compare
-     * @param interaction2 the second value selection to compare
+     * <p>
+     * The provided equality level can be used to restrict the quality check to the given level.
+     * This is done for optimization purposes. The returned equality level is as concrete as
+     * the provided one. It may be more concrete if there is no difference regarding the
+     * comparison on the levels.
+     * </p>
+     *
+     * @param interaction1  the first value selection to compare
+     * @param interaction2  the second value selection to compare
+     * @param equalityLevel the equality level to be checked for
      * 
      * @return as described
