From 9885d3e506ae964bf537419b30eb2ad2b2c4c9b0 Mon Sep 17 00:00:00 2001 From: Alexander Brandes Date: Thu, 15 Jun 2023 17:24:21 +0200 Subject: [PATCH] Fill in 'since' annotations --- .../plotsquared/bukkit/generator/BukkitPlotGenerator.java | 2 +- .../plotsquared/bukkit/util/TranslationUpdateManager.java | 2 +- .../com/plotsquared/core/configuration/caption/Caption.java | 2 +- .../core/configuration/caption/CaptionHolder.java | 4 ++-- .../core/generator/IndependentPlotGenerator.java | 6 +++--- .../main/java/com/plotsquared/core/plot/flag/PlotFlag.java | 2 +- .../com/plotsquared/core/plot/world/PlotAreaManager.java | 2 +- .../java/com/plotsquared/core/queue/QueueCoordinator.java | 2 +- .../core/queue/ZeroedDelegateScopedQueueCoordinator.java | 4 ++-- .../main/java/com/plotsquared/core/util/ChunkManager.java | 6 +++--- .../java/com/plotsquared/core/util/ComponentHelper.java | 6 +++--- 11 files changed, 19 insertions(+), 19 deletions(-) diff --git a/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BukkitPlotGenerator.java b/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BukkitPlotGenerator.java index 08c669f66..6d7e2accb 100644 --- a/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BukkitPlotGenerator.java +++ b/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BukkitPlotGenerator.java @@ -290,7 +290,7 @@ public class BukkitPlotGenerator extends ChunkGenerator implements GeneratorWrap */ @SuppressWarnings("deprecation") // The entire method is deprecated, but kept for compatibility with <=1.16.2 @Override - @Deprecated(since = "TODO") + @Deprecated(since = "7.0.0") public @NonNull ChunkData generateChunkData( @NonNull World world, @NonNull Random random, int x, int z, @NonNull BiomeGrid biome ) { diff --git a/Bukkit/src/main/java/com/plotsquared/bukkit/util/TranslationUpdateManager.java b/Bukkit/src/main/java/com/plotsquared/bukkit/util/TranslationUpdateManager.java index 1d3459d45..71466eb8c 100644 --- a/Bukkit/src/main/java/com/plotsquared/bukkit/util/TranslationUpdateManager.java +++ b/Bukkit/src/main/java/com/plotsquared/bukkit/util/TranslationUpdateManager.java @@ -32,7 +32,7 @@ import java.util.stream.Stream; * MiniMessage changed the syntax between major releases. To warrant a smooth upgrade, we attempt to replace any occurrences * while loading PlotSquared. * - * @since TODO + * @since 7.0.0 */ @NotPublic public class TranslationUpdateManager { diff --git a/Core/src/main/java/com/plotsquared/core/configuration/caption/Caption.java b/Core/src/main/java/com/plotsquared/core/configuration/caption/Caption.java index fe9875993..21da701ab 100644 --- a/Core/src/main/java/com/plotsquared/core/configuration/caption/Caption.java +++ b/Core/src/main/java/com/plotsquared/core/configuration/caption/Caption.java @@ -40,7 +40,7 @@ public interface Caption { * * @param localeHolder Locale holder * @return {@link ComponentLike} - * @since TODO + * @since 7.0.0 */ @NonNull Component toComponent(@NonNull LocaleHolder localeHolder); diff --git a/Core/src/main/java/com/plotsquared/core/configuration/caption/CaptionHolder.java b/Core/src/main/java/com/plotsquared/core/configuration/caption/CaptionHolder.java index f3cee6446..9f9a57e1e 100644 --- a/Core/src/main/java/com/plotsquared/core/configuration/caption/CaptionHolder.java +++ b/Core/src/main/java/com/plotsquared/core/configuration/caption/CaptionHolder.java @@ -51,7 +51,7 @@ public class CaptionHolder { * Get the {@link TagResolver}s to use when resolving tags in the {@link Caption}. * * @return The tag resolvers to use. - * @since TODO + * @since 7.0.0 */ public TagResolver[] getTagResolvers() { return this.tagResolvers; @@ -61,7 +61,7 @@ public class CaptionHolder { * Set the {@link TagResolver}s to use when resolving tags in the {@link Caption}. * * @param tagResolvers The tag resolvers to use. - * @since TODO + * @since 7.0.0 */ public void setTagResolvers(TagResolver... tagResolvers) { this.tagResolvers = tagResolvers; diff --git a/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java b/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java index 2db2fd699..06dc7f775 100644 --- a/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java +++ b/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java @@ -46,7 +46,7 @@ public abstract class IndependentPlotGenerator { * @param result Queue to write to * @param settings PlotArea (settings) * @param biomes If biomes should be generated - * @since TODO + * @since 7.0.0 */ public abstract void generateChunk(ZeroedDelegateScopedQueueCoordinator result, PlotArea settings, boolean biomes); @@ -55,7 +55,7 @@ public abstract class IndependentPlotGenerator { * * @param result Queue to write to * @param setting PlotArea (settings) - * @since TODO + * @since 7.0.0 */ public void populateChunk(ZeroedDelegateScopedQueueCoordinator result, PlotArea setting) { } @@ -108,7 +108,7 @@ public abstract class IndependentPlotGenerator { * @param y World y position * @param z World z position * @return Biome type to be generated - * @since TODO + * @since 7.0.0 */ public abstract BiomeType getBiome(PlotArea settings, int x, int y, int z); diff --git a/Core/src/main/java/com/plotsquared/core/plot/flag/PlotFlag.java b/Core/src/main/java/com/plotsquared/core/plot/flag/PlotFlag.java index 564b29298..c9685ebb0 100644 --- a/Core/src/main/java/com/plotsquared/core/plot/flag/PlotFlag.java +++ b/Core/src/main/java/com/plotsquared/core/plot/flag/PlotFlag.java @@ -88,7 +88,7 @@ public abstract class PlotFlag> { * Gets the flag name as a Kyori {@link Component} * * @see #getFlagName(Class) - * @since TODO + * @since 7.0.0 */ public static > Component getFlagNameComponent(Class flagClass) { return Component.text(getFlagName(flagClass)); diff --git a/Core/src/main/java/com/plotsquared/core/plot/world/PlotAreaManager.java b/Core/src/main/java/com/plotsquared/core/plot/world/PlotAreaManager.java index b265e9394..257894b8a 100644 --- a/Core/src/main/java/com/plotsquared/core/plot/world/PlotAreaManager.java +++ b/Core/src/main/java/com/plotsquared/core/plot/world/PlotAreaManager.java @@ -111,7 +111,7 @@ public interface PlotAreaManager { * * @param worldName Name of the world to add * @return {@code true} if successful, {@code false} if world already existed - * @since TODO + * @since 7.0.0 */ boolean addWorld(@NonNull String worldName); diff --git a/Core/src/main/java/com/plotsquared/core/queue/QueueCoordinator.java b/Core/src/main/java/com/plotsquared/core/queue/QueueCoordinator.java index b069edbf0..ff2b45b17 100644 --- a/Core/src/main/java/com/plotsquared/core/queue/QueueCoordinator.java +++ b/Core/src/main/java/com/plotsquared/core/queue/QueueCoordinator.java @@ -66,7 +66,7 @@ public abstract class QueueCoordinator { * @param x chunk x coordinate * @param z chunk z coordinate * @return a new {@link ZeroedDelegateScopedQueueCoordinator} - * @since TODO + * @since 7.0.0 */ public ZeroedDelegateScopedQueueCoordinator getForChunk(int x, int z, int minY, int maxY) { int bx = x << 4; diff --git a/Core/src/main/java/com/plotsquared/core/queue/ZeroedDelegateScopedQueueCoordinator.java b/Core/src/main/java/com/plotsquared/core/queue/ZeroedDelegateScopedQueueCoordinator.java index 086c3c3a4..2bae6ee6a 100644 --- a/Core/src/main/java/com/plotsquared/core/queue/ZeroedDelegateScopedQueueCoordinator.java +++ b/Core/src/main/java/com/plotsquared/core/queue/ZeroedDelegateScopedQueueCoordinator.java @@ -32,7 +32,7 @@ import org.checkerframework.checker.nullness.qual.Nullable; * zero in the x and z directions, i.e. starting from 0,0. An offset of the minimum point of the region will then be applied to * x and z. * - * @since TODO + * @since 7.0.0 */ public class ZeroedDelegateScopedQueueCoordinator extends DelegateQueueCoordinator { @@ -50,7 +50,7 @@ public class ZeroedDelegateScopedQueueCoordinator extends DelegateQueueCoordinat /** * Create a new ScopedQueueCoordinator instance that delegates to a given QueueCoordinator. Locations are inclusive. * - * @since TODO + * @since 7.0.0 */ public ZeroedDelegateScopedQueueCoordinator(@Nullable QueueCoordinator parent, @NonNull Location min, @NonNull Location max) { super(parent); diff --git a/Core/src/main/java/com/plotsquared/core/util/ChunkManager.java b/Core/src/main/java/com/plotsquared/core/util/ChunkManager.java index 76ba793d1..e526d616b 100644 --- a/Core/src/main/java/com/plotsquared/core/util/ChunkManager.java +++ b/Core/src/main/java/com/plotsquared/core/util/ChunkManager.java @@ -36,7 +36,7 @@ public abstract class ChunkManager { private static final Map> addChunks = new ConcurrentHashMap<>(); /** - * @since TODO + * @since 7.0.0 */ public static void setChunkInPlotArea( RunnableVal force, @@ -76,7 +76,7 @@ public abstract class ChunkManager { } /** - * @since TODO + * @since 7.0.0 */ public static boolean preProcessChunk(BlockVector2 loc, ZeroedDelegateScopedQueueCoordinator queue) { final RunnableVal forceChunk = forceChunks.get(loc); @@ -89,7 +89,7 @@ public abstract class ChunkManager { } /** - * @since TODO + * @since 7.0.0 */ public static boolean postProcessChunk(BlockVector2 loc, ZeroedDelegateScopedQueueCoordinator queue) { final RunnableVal addChunk = forceChunks.get(loc); diff --git a/Core/src/main/java/com/plotsquared/core/util/ComponentHelper.java b/Core/src/main/java/com/plotsquared/core/util/ComponentHelper.java index 2bcbe3a55..9035c200c 100644 --- a/Core/src/main/java/com/plotsquared/core/util/ComponentHelper.java +++ b/Core/src/main/java/com/plotsquared/core/util/ComponentHelper.java @@ -27,7 +27,7 @@ import java.util.Collection; /** * A utility class for modifying components. * - * @since TODO + * @since 7.0.0 */ public class ComponentHelper { @@ -37,7 +37,7 @@ public class ComponentHelper { * @param components The components to join * @param delimiter The delimiter to use between the components * @return The joined components - * @since TODO + * @since 7.0.0 */ public static ComponentLike join(Collection components, Component delimiter) { return join(components.toArray(ComponentLike[]::new), delimiter); @@ -49,7 +49,7 @@ public class ComponentHelper { * @param components The components to join * @param delimiter The delimiter to use between the components * @return The joined components - * @since TODO + * @since 7.0.0 */ public static Component join(ComponentLike[] components, Component delimiter) { TextComponent.Builder builder = Component.text();