#1082: Add "since" to Deprecation annotations

By: DerFrZocker <derrieple@gmail.com>

paper-api/src/main/java/org/bukkit/plugin/PluginAwareness.java

@@ -21,7 +21,7 @@ public interface PluginAwareness {
          *
          * @deprecated all plugins are now assumed to be UTF-8 aware.
          */
-        @Deprecated
+        @Deprecated(since = "1.9")
         UTF8,
         ;
     }

paper-api/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java

@@ -990,7 +990,7 @@ public final class PluginDescriptionFile {
      * @return unused
      * @deprecated unused
      */
-    @Deprecated
+    @Deprecated(since = "1.7.2")
     @Nullable
     public String getClassLoaderOf() {
         return classLoaderOf;

paper-api/src/main/java/org/bukkit/plugin/SimplePluginManager.java

@@ -707,7 +707,7 @@ public final class SimplePluginManager implements PluginManager {
         addPermission(perm, true);
     }
 
-    @Deprecated
+    @Deprecated(since = "1.12")
     public void addPermission(@NotNull Permission perm, boolean dirty) {
         String name = perm.getName().toLowerCase(Locale.ROOT);
 
@@ -760,7 +760,7 @@ public final class SimplePluginManager implements PluginManager {
         }
     }
 
-    @Deprecated
+    @Deprecated(since = "1.12")
     public void dirtyPermissibles() {
         dirtyPermissibles(true);
         dirtyPermissibles(false);

paper-api/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java

@@ -59,7 +59,7 @@ public final class JavaPluginLoader implements PluginLoader {
      *
      * @param instance the server instance
      */
-    @Deprecated
+    @Deprecated(since = "1.4.5")
     public JavaPluginLoader(@NotNull Server instance) {
         Preconditions.checkArgument(instance != null, "Server cannot be null");
         server = instance;

paper-api/src/main/java/org/bukkit/plugin/messaging/StandardMessenger.java

@@ -468,7 +468,7 @@ public class StandardMessenger implements Messenger {
      * @param channel Channel name to validate.
      * @deprecated not an API method
      */
-    @Deprecated
+    @Deprecated(since = "1.13")
     public static void validateChannel(@NotNull String channel) {
         validateAndCorrectChannel(channel);
     }
@@ -480,7 +480,7 @@ public class StandardMessenger implements Messenger {
      * @return corrected channel name
      * @deprecated not an API method
      */
-    @Deprecated
+    @Deprecated(since = "1.13")
     @NotNull
     public static String validateAndCorrectChannel(@NotNull String channel) {
         if (channel == null) {