Index: trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/StyledMapRenderer.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/StyledMapRenderer.java	(revision 11284)
+++ trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/StyledMapRenderer.java	(revision 11285)
@@ -756,4 +756,9 @@
     }
 
+    /**
+     * Draw a text onto a node
+     * @param n The node to draw the text on
+     * @param bs The text and it's alignment.
+     */
     public void drawBoxText(Node n, BoxTextElement bs) {
         if (!isShowNames() || bs == null)
Index: trunk/src/org/openstreetmap/josm/gui/mappaint/styleelement/AreaElement.java
===================================================================
--- trunk/src/org/openstreetmap/josm/gui/mappaint/styleelement/AreaElement.java	(revision 11284)
+++ trunk/src/org/openstreetmap/josm/gui/mappaint/styleelement/AreaElement.java	(revision 11285)
@@ -19,4 +19,7 @@
 import org.openstreetmap.josm.tools.Utils;
 
+/**
+ * This is the style that defines how an area is filled.
+ */
 public class AreaElement extends StyleElement {
 
@@ -26,7 +29,29 @@
      */
     public Color color;
+
+    /**
+     * An image to cover this area. May be null to disable this feature.
+     */
     public MapImage fillImage;
+
+    /**
+     * The text that should be written on this area.
+     */
     public TextLabel text;
+
+    /**
+     * Fill the area only partially from the borders
+     * <p>
+     * Public access is discouraged.
+     * @see StyledMapRenderer#drawArea(Way, Color, MapImage, Float, Float, boolean, TextLabel)
+     */
     public Float extent;
+
+    /**
+     * Areas smaller than this are filled no matter what value {@link #extent} has.
+     * <p>
+     * Public access is discouraged.
+     * @see StyledMapRenderer#drawArea(Way, Color, MapImage, Float, Float, boolean, TextLabel)
+     */
     public Float extentThreshold;
 
@@ -41,4 +66,9 @@
     }
 
+    /**
+     * Create a new {@link AreaElement}
+     * @param env The current style definitions
+     * @return The area element or <code>null</code> if the area should not be filled.
+     */
     public static AreaElement create(final Environment env) {
         final Cascade c = env.mc.getCascade(env.layer);