Index: /trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/PaintColors.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/PaintColors.java	(revision 12375)
+++ /trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/PaintColors.java	(revision 12376)
@@ -14,23 +14,76 @@
 import org.openstreetmap.josm.gui.mappaint.StyleSource;
 
+/**
+ * The colors used to paint the map, especially with the wireframe renderer
+ * <p>
+ * This enum stores the colors to be set in the preferences
+ */
 public enum PaintColors {
 
+    /**
+     * Inactive objects
+     */
     INACTIVE(marktr("inactive"), Color.darkGray),
+    /**
+     * Currently selected objects
+     */
     SELECTED(marktr("selected"), Color.red),
+    /**
+     * Objects that are part of a selected relation
+     */
     RELATIONSELECTED(marktr("Relation: selected"), Color.magenta),
+    /**
+     * Normal nodes
+     */
     NODE(marktr("Node: standard"), Color.yellow),
+    /**
+     * Connected nodes
+     */
     CONNECTION(marktr("Node: connection"), Color.yellow),
+    /**
+     * A tagged node
+     */
     TAGGED(marktr("Node: tagged"), new Color(204, 255, 255)), // light cyan
+    /**
+     * Default way color
+     */
     DEFAULT_WAY(marktr("way"), new Color(0, 0, 128)), // dark blue
+    /**
+     * Relation color
+     */
     RELATION(marktr("relation"), new Color(0, 128, 128)), // teal
+    /**
+     * Color for untagged way
+     */
     UNTAGGED_WAY(marktr("untagged way"), new Color(0, 128, 0)), // dark green
+    /**
+     * Background of the map
+     */
     BACKGROUND(marktr("background"), Color.BLACK),
+    /**
+     * Highlight around a selected node/way, MapCSS renderer
+     */
     HIGHLIGHT(marktr("highlight"), SELECTED.get()),
+    /**
+     * Highlight around a selected node/way, Wireframe renderer
+     */
     HIGHLIGHT_WIREFRAME(marktr("highlight wireframe"), Color.orange),
 
+    /**
+     * Untagged way
+     */
     UNTAGGED(marktr("untagged"), Color.GRAY),
+    /**
+     * Default text color
+     */
     TEXT(marktr("text"), Color.WHITE),
+    /**
+     * Default text color for areas
+     */
     AREA_TEXT(marktr("areatext"), Color.LIGHT_GRAY);
 
+    /**
+     * The name of the color
+     */
     private final String name;
     private final Color defaultColor;
Index: /trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/StyledMapRenderer.java
===================================================================
--- /trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/StyledMapRenderer.java	(revision 12375)
+++ /trunk/src/org/openstreetmap/josm/data/osm/visitor/paint/StyledMapRenderer.java	(revision 12376)
@@ -913,4 +913,10 @@
     }
 
+    /**
+     * Draw a turn restriction
+     * @param r The turn restriction relation
+     * @param icon The icon to draw at the turn point
+     * @param disabled draw using disabled style
+     */
     public void drawRestriction(Relation r, MapImage icon, boolean disabled) {
         Way fromWay = null;
@@ -1525,8 +1531,16 @@
     }
 
+    /**
+     * Check if icons should be rendered
+     * @return <code>true</code> to display icons
+     */
     public boolean isShowIcons() {
         return showIcons;
     }
 
+    /**
+     * Test if names should be rendered
+     * @return <code>true</code> to display names
+     */
     public boolean isShowNames() {
         return showNames;