From f5fa15080cfaffc14ca5a925fe2c18199de616a8 Mon Sep 17 00:00:00 2001 From: MattBDev <4009945+MattBDev@users.noreply.github.com> Date: Mon, 22 Apr 2019 11:45:23 -0400 Subject: [PATCH] Minor javadoc updates --- .../plotsquared/plot/object/OfflinePlotPlayer.java | 11 ++++++----- .../plotsquared/plot/object/PlotPlayer.java | 8 ++++++-- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/OfflinePlotPlayer.java b/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/OfflinePlotPlayer.java index 709a7cee6..85e6e72d8 100644 --- a/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/OfflinePlotPlayer.java +++ b/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/OfflinePlotPlayer.java @@ -5,28 +5,29 @@ import java.util.UUID; public interface OfflinePlotPlayer { /** - * Get the {@code UUID} of this player + * Gets the {@code UUID} of this player * * @return the player {@link UUID} */ UUID getUUID(); /** - * Get the time in milliseconds when the player was last seen online. + * Gets the time in milliseconds when the player was last seen online. * * @return the time in milliseconds when last online + * @deprecated This method may be inconsistent across platforms. The javadoc may be wrong depending on which platform is used. */ - long getLastPlayed(); + @SuppressWarnings("DeprecatedIsStillUsed") @Deprecated long getLastPlayed(); /** * Checks if this player is online. * - * @return true if this player is online + * @return {@code true} if this player is online */ boolean isOnline(); /** - * Get the name of this player. + * Gets the name of this player. * * @return the player name */ diff --git a/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/PlotPlayer.java b/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/PlotPlayer.java index a08017a12..c850513cd 100644 --- a/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/PlotPlayer.java +++ b/Core/src/main/java/com/github/intellectualsites/plotsquared/plot/object/PlotPlayer.java @@ -426,12 +426,16 @@ public abstract class PlotPlayer implements CommandCaller, OfflinePlotPlayer { */ public abstract void setTime(long time); + /** + * Determines whether or not the player can fly. + * @return {@code true} if the player is allowed to fly + */ public abstract boolean getFlight(); /** - * Set this player's fly mode. + * Sets whether or not this player can fly. * - * @param fly if the player can fly + * @param fly {@code true} if the player can fly, otherwise {@code false} */ public abstract void setFlight(boolean fly);