src/java.desktop/share/classes/javax/swing/border/EtchedBorder.java

@@ -57,12 +57,21 @@
     /** Raised etched type. */
     public static final int RAISED  = 0;
     /** Lowered etched type. */
     public static final int LOWERED = 1;
 
+    /**
+     * The type of etch to be drawn by the border.
+     */
     protected int etchType;
+    /**
+     * The color to use for the etched highlight.
+     */
     protected Color highlight;
+    /**
+     * The color to use for the etched shadow.
+     */
     protected Color shadow;
 
     /**
      * Creates a lowered etched border whose colors will be derived
      * from the background color of the component passed into