From bbc211fababff068d01b5f75b985156558f93d3e Mon Sep 17 00:00:00 2001
From: Bukkit/Spigot <noreply+git-bukkit@papermc.io>
Date: Tue, 8 Jul 2014 23:56:15 -0500
Subject: [PATCH] Pulling all pending Bukkit-JavaDoc changes

By: Wesley Wolfe <wesley.d.wolfe+git@gmail.com>
---
 paper-api/src/main/java/org/bukkit/GameMode.java         | 2 +-
 paper-api/src/main/java/org/bukkit/Location.java         | 2 +-
 .../src/main/java/org/bukkit/entity/HumanEntity.java     | 4 ++--
 .../java/org/bukkit/event/player/PlayerFishEvent.java    | 9 ++++++---
 4 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/paper-api/src/main/java/org/bukkit/GameMode.java b/paper-api/src/main/java/org/bukkit/GameMode.java
index 47b2d90bda..f85ed0b25b 100644
--- a/paper-api/src/main/java/org/bukkit/GameMode.java
+++ b/paper-api/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);
 
diff --git a/paper-api/src/main/java/org/bukkit/Location.java b/paper-api/src/main/java/org/bukkit/Location.java
index 9e1e604570..5c18507baa 100644
--- a/paper-api/src/main/java/org/bukkit/Location.java
+++ b/paper-api/src/main/java/org/bukkit/Location.java
@@ -219,7 +219,7 @@ public class Location implements Cloneable {
     }
 
     /**
-     * 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
diff --git a/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java b/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java
index 6f70db4d17..3f8646ddcb 100644
--- a/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java
+++ b/paper-api/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
      */
diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerFishEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerFishEvent.java
index e92acdfc29..7416a0ae0c 100644
--- a/paper-api/src/main/java/org/bukkit/event/player/PlayerFishEvent.java
+++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerFishEvent.java
@@ -37,10 +37,13 @@ public class PlayerFishEvent extends PlayerEvent implements Cancellable {
     }
 
     /**
-     * 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;