Index: trunk/src/org/openstreetmap/josm/data/osm/BBox.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/BBox.java	(revision 3208)
+++ trunk/src/org/openstreetmap/josm/data/osm/BBox.java	(revision 3209)
@@ -78,4 +78,7 @@
     }
 
+    /**
+     * Extends this bbox to include the point (x, y)
+     */
     public void add(double x, double y) {
         xmin = Math.min(xmin, x);
@@ -105,4 +108,8 @@
     }
 
+    /**
+     * Tests, weather the bbox b lies completely inside
+     * this bbox.
+     */
     public boolean bounds(BBox b) {
         if (!(xmin <= b.xmin) ||
@@ -114,4 +121,7 @@
     }
 
+    /**
+     * Tests, weather the Point c lies within the bbox.
+     */
     public boolean bounds(LatLon c) {
         if ((xmin <= c.lon()) &&
@@ -123,5 +133,9 @@
     }
 
-    public boolean inside(BBox b) {
+    /**
+     * Tests, weather two BBoxes intersect as an area.
+     * I.e. weather there exists a point that lies in both of them.
+     */
+    public boolean intersects(BBox b) {
         if (xmin > b.xmax)
             return false;
@@ -135,8 +149,7 @@
     }
 
-    public boolean intersects(BBox b) {
-        return this.inside(b) || b.inside(this);
-    }
-
+    /**
+     * Returns a list of all 4 corners of the bbox rectangle.
+     */
     public List<LatLon> points()  {
         LatLon p1 = new LatLon(ymin, xmin);