Index: trunk/src/org/openstreetmap/josm/tools/ImageProvider.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/ImageProvider.java	(revision 7730)
+++ trunk/src/org/openstreetmap/josm/tools/ImageProvider.java	(revision 7731)
@@ -95,5 +95,12 @@
      */
     public static enum OverlayPosition {
-        NORTHWEST, NORTHEAST, SOUTHWEST, SOUTHEAST
+        /** North west */
+        NORTHWEST,
+        /** North east */
+        NORTHEAST,
+        /** South west */
+        SOUTHWEST,
+        /** South east */
+        SOUTHEAST
     }
 
@@ -113,13 +120,13 @@
      */
     public static enum ImageSizes {
-        /* SMALL_ICON value of on Action */
+        /** SMALL_ICON value of on Action */
         SMALLICON,
-        /* LARGE_ICON_KEY value of on Action */
+        /** LARGE_ICON_KEY value of on Action */
         LARGEICON,
-        /* MAP icon */
+        /** MAP icon */
         MAP,
-        /* MAP icon maximum size */
+        /** MAP icon maximum size */
         MAPMAX,
-        /* MENU icon size */
+        /** MENU icon size */
         MENU,
     }
@@ -169,4 +176,8 @@
      */
     public interface ImageCallback {
+        /**
+         * Called when image loading has finished.
+         * @param result the loaded image icon
+         */
         void finished(ImageIcon result);
     }
@@ -177,4 +188,8 @@
      */
     public interface ImageResourceCallback {
+        /**
+         * Called when image loading has finished.
+         * @param result the loaded image resource
+         */
         void finished(ImageResource result);
     }
@@ -247,5 +262,6 @@
     /**
      * Convert enumerated size values to real numbers
-     * @return dimension of image
+     * @param size the size enumeration
+     * @return dimension of image in pixels
      * @since 7687
      */
@@ -496,4 +512,6 @@
 
     /**
+     * Load an image with a given file name.
+     *
      * @param name The icon name (base name with or without '.png' or '.svg' extension)
      * @return the requested image or null if the request failed
@@ -933,4 +951,11 @@
     }
 
+    /**
+     * Load a cursor with a given file name, optionally decorated with an overlay image.
+     *
+     * @param name the cursor image filename in "cursor" directory
+     * @param overlay optional overlay image
+     * @return cursor with a given file name, optionally decorated with an overlay image
+     */
     public static Cursor getCursor(String name, String overlay) {
         ImageIcon img = get("cursor", name);
@@ -1111,4 +1136,10 @@
     }
 
+    /**
+     * Constructs an image from the given SVG data.
+     * @param svg the SVG data
+     * @param dim the desired image dimension
+     * @return an image from the given SVG data at the desired dimension.
+     */
     public static BufferedImage createImageFromSvg(SVGDiagram svg, Dimension dim) {
         float realWidth = svg.getWidth();
Index: trunk/src/org/openstreetmap/josm/tools/ImageResource.java
===================================================================
--- trunk/src/org/openstreetmap/josm/tools/ImageResource.java	(revision 7730)
+++ trunk/src/org/openstreetmap/josm/tools/ImageResource.java	(revision 7731)
@@ -8,6 +8,6 @@
 import java.util.Map;
 
+import javax.swing.AbstractAction;
 import javax.swing.Action;
-import javax.swing.AbstractAction;
 import javax.swing.ImageIcon;
 
@@ -29,6 +29,13 @@
     private Map<Dimension, Image> imgCache = new HashMap<>();
     private SVGDiagram svg;
+    /**
+     * Use this dimension to request original file dimension.
+     */
     public static final Dimension DEFAULT_DIMENSION = new Dimension(-1, -1);
 
+    /**
+     * Constructs a new {@code ImageResource} from an image.
+     * @param img the image
+     */
     public ImageResource(Image img) {
         CheckParameterUtil.ensureParameterNotNull(img);
@@ -36,4 +43,8 @@
     }
 
+    /**
+     * Constructs a new {@code ImageResource} from SVG data.
+     * @param svg SVG data
+     */
     public ImageResource(SVGDiagram svg) {
         CheckParameterUtil.ensureParameterNotNull(svg);
@@ -41,4 +52,8 @@
     }
 
+    /**
+     * Returns the image icon at default dimension.
+     * @return the image icon at default dimension
+     */
     public ImageIcon getImageIcon() {
         return getImageIcon(DEFAULT_DIMENSION);
@@ -47,5 +62,5 @@
     /**
      * Set both icons of an Action
-     * @param action The action for the icons
+     * @param a The action for the icons
      * @since 7693
      */
@@ -56,5 +71,5 @@
         a.putValue(Action.LARGE_ICON_KEY, icon);
     }
-    
+
     /**
      * Get an ImageIcon object for the image of this resource