Index: /trunk/src/org/openstreetmap/josm/tools/Pair.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/tools/Pair.java	(revision 9541)
+++ /trunk/src/org/openstreetmap/josm/tools/Pair.java	(revision 9542)
@@ -47,4 +47,10 @@
     }
 
+    /**
+     * Converts a single-typed pair to a list.
+     * @param <T> type of both elements
+     * @param p pair
+     * @return list containing a and b
+     */
     public static <T> List<T> toList(Pair<T, T> p) {
         List<T> l = new ArrayList<>(2);
@@ -54,4 +60,10 @@
     }
 
+    /**
+     * Sorts a single-typed pair so {@code a <= b}.
+     * @param <T> type of both elements
+     * @param p pair
+     * @return {@code p}
+     */
     public static <T> Pair<T, T> sort(Pair<T, T> p) {
         if (p.b.hashCode() < p.a.hashCode()) {