From 2c7d3da590e5fea94ade871f905f8cb305e9dede Mon Sep 17 00:00:00 2001
From: ShanerX <shanerx@shanerx.org>
Date: Sun, 16 Apr 2023 09:54:51 +1000
Subject: [PATCH] #279: Minor edits to various Javadocs

---
 src/main/java/org/bukkit/Nameable.java               | 3 +++
 src/main/java/org/bukkit/OfflinePlayer.java          | 5 +++++
 src/main/java/org/bukkit/event/Cancellable.java      | 3 +++
 src/main/java/org/bukkit/plugin/java/JavaPlugin.java | 4 +++-
 4 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/bukkit/Nameable.java b/src/main/java/org/bukkit/Nameable.java
index fee814e0..b79daa85 100644
--- a/src/main/java/org/bukkit/Nameable.java
+++ b/src/main/java/org/bukkit/Nameable.java
@@ -2,6 +2,9 @@ package org.bukkit;
 
 import org.jetbrains.annotations.Nullable;
 
+/**
+ * Represents a block, entity, or other object that may receive a custom name.
+ */
 public interface Nameable {
 
     /**
diff --git a/src/main/java/org/bukkit/OfflinePlayer.java b/src/main/java/org/bukkit/OfflinePlayer.java
index c5eed323..5acb0d36 100644
--- a/src/main/java/org/bukkit/OfflinePlayer.java
+++ b/src/main/java/org/bukkit/OfflinePlayer.java
@@ -10,6 +10,11 @@ import org.bukkit.profile.PlayerProfile;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+/**
+ * Represents a reference to a player identity and the data belonging to a
+ * player that is stored on the disk and can, thus, be retrieved without the
+ * player needing to be online.
+ */
 public interface OfflinePlayer extends ServerOperator, AnimalTamer, ConfigurationSerializable {
 
     /**
diff --git a/src/main/java/org/bukkit/event/Cancellable.java b/src/main/java/org/bukkit/event/Cancellable.java
index 799b0b0f..9e836d30 100644
--- a/src/main/java/org/bukkit/event/Cancellable.java
+++ b/src/main/java/org/bukkit/event/Cancellable.java
@@ -1,5 +1,8 @@
 package org.bukkit.event;
 
+/**
+ * A type characterizing events that may be cancelled by a plugin or the server.
+ */
 public interface Cancellable {
 
     /**
diff --git a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java
index 669a70fa..ee100b7a 100644
--- a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java
+++ b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java
@@ -30,7 +30,9 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 /**
- * Represents a Java plugin
+ * Represents a Java plugin and its main class. It contains fundamental methods
+ * and fields for a plugin to be loaded and work properly. This is an indirect
+ * implementation of {@link org.bukkit.plugin.Plugin}.
  */
 public abstract class JavaPlugin extends PluginBase {
     private boolean isEnabled = false;