Index: trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/RelationSortUtils.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/RelationSortUtils.java	(revision 12657)
+++ trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/RelationSortUtils.java	(revision 12658)
@@ -12,4 +12,7 @@
 import org.openstreetmap.josm.gui.dialogs.relation.sort.WayConnectionType.Direction;
 
+/**
+ * Utility classes for the {@link RelationSorter}.
+ */
 final class RelationSortUtils {
 
Index: trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/RelationSorter.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/RelationSorter.java	(revision 12657)
+++ trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/RelationSorter.java	(revision 12658)
@@ -19,4 +19,9 @@
 import org.openstreetmap.josm.tools.Utils;
 
+/**
+ * This class sorts the relation members by connectivity.
+ * <p>
+ * Multiple {@link AdditionalSorter}s are implemented to handle special relation types.
+ */
 public class RelationSorter {
 
@@ -170,4 +175,9 @@
     }
 
+    /**
+     * Sorts a list of members by connectivity
+     * @param defaultMembers The members to sort
+     * @return A sorted list of the same members
+     */
     public static List<RelationMember> sortMembersByConnectivity(List<RelationMember> defaultMembers) {
 
Index: trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/WayConnectionType.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/WayConnectionType.java	(revision 12657)
+++ trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/WayConnectionType.java	(revision 12658)
@@ -5,4 +5,7 @@
 import static org.openstreetmap.josm.tools.I18n.tr;
 
+/**
+ * A class used by the {@link RelationSorter} to store if two ways are already connected
+ */
 public class WayConnectionType {
 
@@ -10,6 +13,7 @@
     private final boolean invalid;
 
-    /** True, if linked to the previous / next member.  */
+    /** True, if linked to the previous member.  */
     public boolean linkPrev;
+    /** True, if linked to the next member.  */
     public boolean linkNext;
 
Index: trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/WayConnectionTypeCalculator.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/WayConnectionTypeCalculator.java	(revision 12657)
+++ trunk/src/org/openstreetmap/josm/gui/dialogs/relation/sort/WayConnectionTypeCalculator.java	(revision 12658)
@@ -16,4 +16,7 @@
 import org.openstreetmap.josm.tools.bugreport.BugReport;
 
+/**
+ * This class calculates the {@link WayConnectionType} for a given list of members
+ */
 public class WayConnectionTypeCalculator {