Pulling all pending Bukkit-JavaDoc changes

src/main/java/org/bukkit/GameMode.java

@@ -23,7 +23,7 @@ public enum GameMode {
     SURVIVAL(0),
 
     /**
-     * Adventure mode cannot break blocks, use chat, use buckets, etc.
+     * Adventure mode cannot break blocks without the correct tools.
      */
     ADVENTURE(2);
 

src/main/java/org/bukkit/Location.java

@@ -219,7 +219,7 @@ public void setPitch(float pitch) {
     }
 
     /**
-     * Sets the pitch of this location, measured in degrees.
+     * Gets the pitch of this location, measured in degrees.
      * <ul>
      * <li>A pitch of 0 represents level forward facing.
      * <li>A pitch of 90 represents downward facing, or negative y

src/main/java/org/bukkit/entity/HumanEntity.java

@@ -148,14 +148,14 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, Permissible, Inv
     public int getSleepTicks();
 
     /**
-     * Gets this humans current {@link GameMode}
+     * Gets this human's current {@link GameMode}
      *
      * @return Current game mode
      */
     public GameMode getGameMode();
 
     /**
-     * Sets this humans current {@link GameMode}
+     * Sets this human's current {@link GameMode}
      *
      * @param mode New game mode
      */

src/main/java/org/bukkit/event/player/PlayerFishEvent.java

@@ -37,10 +37,13 @@ public PlayerFishEvent(final Player player, final Entity entity, final Fish hook
     }
 
     /**
-     * Gets the entity caught by the player
+     * Gets the entity caught by the player.
+     * <p>
+     * If player has fished successfully, the result may be cast to {@link
+     * Item}.
      *
-     * @return Entity caught by the player, null if fishing, bobber has gotten
-     *     stuck in the ground or nothing has been caught
+     * @return Entity caught by the player, Entity if fishing, and null if
+     *     bobber has gotten stuck in the ground or nothing has been caught
      */
     public Entity getCaught() {
         return entity;