Fix some enums documentation

Author: JasperGeurtz

src/main/java/bwapi/BulletType.java

@@ -3,7 +3,9 @@
 import java.util.Arrays;
 
 /**
- * Enum containing bullet types.
+ * This enum represents a type of bullet.
+ *
+ * Internally, these are the same IDs as flingy types in Broodwar.
  */
 public enum BulletType {
     Melee(0),

src/main/java/bwapi/Color.java

@@ -10,17 +10,53 @@
  * limited to this palette.
  */
 public class Color {
+    /**
+     * The default color for Player 1.
+     */
     public final static Color Red = new Color(111);
+    /**
+     * The default color for Player 2.
+     */
     public final static Color Blue = new Color(165);
+    /**
+     * The default color for Player 3.
+     */
     public final static Color Teal = new Color(159);
+    /**
+     * The default color for Player 4.
+     */
     public final static Color Purple = new Color(164);
+    /**
+     * The default color for Player 5.
+     */
     public final static Color Orange = new Color(156);
+    /**
+     * The default color for Player 6.
+     */
     public final static Color Brown = new Color(19);
+    /**
+     * A bright white. Note that this is lighter than Player 7's white.
+     */
     public final static Color White = new Color(255);
+    /**
+     * The default color for Player 8.
+     */
     public final static Color Yellow = new Color(135);
+    /**
+     * The alternate color for Player 7 on Ice tilesets.
+     */
     public final static Color Green = new Color(117);
+    /**
+     * The default color for Neutral (Player 12).
+     */
     public final static Color Cyan = new Color(128);
+    /**
+     * The color black.
+     */
     public final static Color Black = new Color(0);
+    /**
+     * The color grey.
+     */
     public final static Color Grey = new Color(74);
 
     private static final RGBQUAD RGBRESERVE = new RGBQUAD(0, 0, 0, 0xFF);

src/main/java/bwapi/CommandType.java

@@ -2,6 +2,9 @@
 
 import java.util.Arrays;
 
+/**
+ * Used in {@link UnitCommand}.
+ */
 public enum CommandType {
     None(0),
     SetScreenPosition(1),

src/main/java/bwapi/CoordinateType.java

@@ -3,12 +3,24 @@
 import java.util.Arrays;
 
 /**
- * Contains the coordinate type enumeration for relative drawing positions.
+ * The coordinate type enumeration for relative drawing positions.
  */
 public enum CoordinateType {
+    /**
+     * A default value for uninitialized coordinate types.
+     */
     None(0),
+    /**
+     * {@link Position#Origin} (0,0) corresponds to the top left corner of the <b>screen</b>
+     */
     Screen(1),
+    /**
+     * {@link Position#Origin} (0,0) corresponds to the top left corner of the <b>map</b>
+     */
     Map(2),
+    /**
+     * {@link Position#Origin} (0,0) corresponds to the top left corner of the <b>mouse cursor</b>
+     */
     Mouse(3);
 
     static final CoordinateType[] idToEnum = new CoordinateType[4];

src/main/java/bwapi/DamageType.java

@@ -1,7 +1,13 @@
 package bwapi;
 
 /**
- * Enum containing damage types.
+ * Damage types are used in Broodwar to determine the amount of damage that will be
+ * done to a unit.
+ *
+ * This corresponds with UnitSizeType to determine the damage done to
+ * a unit.
+ * 
+ * @see {@link WeaponType}, {@link DamageType}, {@link UnitSizeType}
  *
  * [View on Liquipedia](http://wiki.teamliquid.net/starcraft/Damage_Type)<br>
  * [View on Starcraft Campendium (Official Website)](http://classic.battle.net/scc/gs/damage.shtml)<br>

src/main/java/bwapi/EventType.java

@@ -3,7 +3,7 @@
 import java.util.Arrays;
 
 /**
- * Enum of event types supported by BWAPI.
+ * Enumeration of callback event types.
  */
 public enum EventType {
     MatchStart(0),

src/main/java/bwapi/ExplosionType.java

@@ -1,7 +1,9 @@
 package bwapi;
 
 /**
- * Enum containing explosion types.
+ * A representation of a weapon's explosion type.
+ *
+ * This indicates how the weapon behaves, such as if it deals splash damage or causes an effect to occur.
  */
 public enum ExplosionType {
     None(0),

src/main/java/bwapi/Flag.java

@@ -5,7 +5,13 @@
  * @see {@link Game#enableFlag}, {@link Game#isFlagEnabled}
  */
 public enum Flag {
+    /**
+     * Enable to get information about all units on the map, not just the visible units.
+     */
     CompleteMapInformation(0),
+    /**
+     * Enable to get information from the user (what units are selected, chat messages the user enters, etc)
+     */
     UserInput(1);
 
     final int id;

src/main/java/bwapi/GameType.java

@@ -3,8 +3,9 @@
 import java.util.Arrays;
 
 /**
- * Namespace containing game types.
- * @see GameType
+ * An enum that represents game types in Broodwar.
+ *
+ * A game type is selected when creating a game.
  */
 public enum GameType {
     None(0),

src/main/java/bwapi/Key.java

@@ -1,5 +1,10 @@
 package bwapi;
 
+/**
+ * An enumeration of keyboard input values.
+ *
+ * @see {@link Game#getKeyState}
+ */
 public enum Key {
     K_LBUTTON(1),
     K_RBUTTON(2),