#1082: Add "since" to Deprecation annotations

By: DerFrZocker <derrieple@gmail.com>

paper-api/src/main/java/org/bukkit/generator/BlockPopulator.java

@@ -35,7 +35,7 @@ public abstract class BlockPopulator {
      * @param source The chunk to generate for
      * @deprecated Use {@link #populate(WorldInfo, Random, int, int, LimitedRegion)}
      */
-    @Deprecated
+    @Deprecated(since = "1.17.1")
     public void populate(@NotNull World world, @NotNull Random random, @NotNull Chunk source) {
     }
 

paper-api/src/main/java/org/bukkit/generator/ChunkGenerator.java

@@ -215,7 +215,7 @@ public abstract class ChunkGenerator {
      * generateBlockSections() or generateExtBlockSections().
      * @deprecated Biomes are now set with {@link BiomeProvider}
      */
-    @Deprecated
+    @Deprecated(since = "1.17.1")
     public interface BiomeGrid {
 
         /**
@@ -227,7 +227,7 @@ public abstract class ChunkGenerator {
          * @deprecated biomes are now 3-dimensional
          */
         @NotNull
-        @Deprecated
+        @Deprecated(since = "1.15")
         Biome getBiome(int x, int z);
 
         /**
@@ -249,7 +249,7 @@ public abstract class ChunkGenerator {
          * @param bio - Biome value
          * @deprecated biomes are now 3-dimensional
          */
-        @Deprecated
+        @Deprecated(since = "1.15")
         void setBiome(int x, int z, @NotNull Biome bio);
 
         /**
@@ -289,7 +289,7 @@ public abstract class ChunkGenerator {
      * @deprecated The generation is now split up and the new methods should be used, see {@link ChunkGenerator}
      */
     @NotNull
-    @Deprecated
+    @Deprecated(since = "1.17.1")
     public ChunkData generateChunkData(@NotNull World world, @NotNull Random random, int x, int z, @NotNull BiomeGrid biome) {
         throw new UnsupportedOperationException("Not implemented, no longer needed");
     }
@@ -301,7 +301,7 @@ public abstract class ChunkGenerator {
      * @deprecated {@link ChunkData} are now directly provided
      */
     @NotNull
-    @Deprecated
+    @Deprecated(since = "1.17.1")
     protected final ChunkData createChunkData(@NotNull World world) {
         return Bukkit.getServer().createChunkData(world);
     }
@@ -363,7 +363,7 @@ public abstract class ChunkGenerator {
      * @return parallel capable status
      * @deprecated the chunk generation code should be thread safe
      */
-    @Deprecated
+    @Deprecated(since = "1.17.1")
     public boolean isParallelCapable() {
         return false;
     }
@@ -452,7 +452,7 @@ public abstract class ChunkGenerator {
      * @return true if the server should generate Vanilla bedrock
      * @deprecated has no effect, bedrock generation is part of the surface step, see {@link #shouldGenerateSurface()}
      */
-    @Deprecated
+    @Deprecated(since = "1.19.2")
     public boolean shouldGenerateBedrock() {
         return false;
     }
@@ -769,7 +769,7 @@ public abstract class ChunkGenerator {
          * @return the block data value or air if x, y or z are outside the chunk's bounds
          * @deprecated Uses magic values
          */
-        @Deprecated
+        @Deprecated(since = "1.8.8")
         public byte getData(int x, int y, int z);
     }
 }