diff --git a/src/main/java/org/bukkit/TreeType.java b/src/main/java/org/bukkit/TreeType.java index 93a729f9..8945e4c9 100644 --- a/src/main/java/org/bukkit/TreeType.java +++ b/src/main/java/org/bukkit/TreeType.java @@ -4,6 +4,7 @@ * Tree and organic structure types. */ public enum TreeType { + /** * Regular tree, no branches */ diff --git a/src/main/java/org/bukkit/Warning.java b/src/main/java/org/bukkit/Warning.java index b1967f6b..fca77cec 100644 --- a/src/main/java/org/bukkit/Warning.java +++ b/src/main/java/org/bukkit/Warning.java @@ -15,10 +15,12 @@ @Target({ElementType.CONSTRUCTOR, ElementType.METHOD, ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) public @interface Warning { + /** * This represents the states that server verbose for warnings may be. */ public enum WarningState { + /** * Indicates all warnings should be printed for deprecated items. */ diff --git a/src/main/java/org/bukkit/command/BlockCommandSender.java b/src/main/java/org/bukkit/command/BlockCommandSender.java index 6dc46607..ce229d24 100644 --- a/src/main/java/org/bukkit/command/BlockCommandSender.java +++ b/src/main/java/org/bukkit/command/BlockCommandSender.java @@ -3,6 +3,7 @@ import org.bukkit.block.Block; public interface BlockCommandSender extends CommandSender { + /** * Returns the block this command sender belongs to * diff --git a/src/main/java/org/bukkit/command/MultipleCommandAlias.java b/src/main/java/org/bukkit/command/MultipleCommandAlias.java index 3a666d16..a0a41295 100644 --- a/src/main/java/org/bukkit/command/MultipleCommandAlias.java +++ b/src/main/java/org/bukkit/command/MultipleCommandAlias.java @@ -11,6 +11,11 @@ public MultipleCommandAlias(String name, Command[] commands) { this.commands = commands; } + /** + * Gets the commands associated with the multi-command alias. + * + * @return commands associated with alias + */ public Command[] getCommands() { return commands; } diff --git a/src/main/java/org/bukkit/command/PluginCommand.java b/src/main/java/org/bukkit/command/PluginCommand.java index ec66c28a..f90ee7e0 100644 --- a/src/main/java/org/bukkit/command/PluginCommand.java +++ b/src/main/java/org/bukkit/command/PluginCommand.java @@ -75,6 +75,7 @@ public CommandExecutor getExecutor() { /** * Sets the {@link TabCompleter} to run when tab-completing this command. + *
* If no TabCompleter is specified, and the command's executor implements
* TabCompleter, then the executor will be used for tab completion.
*
@@ -112,6 +113,7 @@ public Plugin getPlugin() {
* {@link Command#tabComplete(CommandSender, String, String[])}.
*
* This method does not consider permissions.
+ *
* @throws CommandException if the completer or executor throw an exception during the process of tab-completing.
* @throws IllegalArgumentException if sender, alias, or args is null
*/
diff --git a/src/main/java/org/bukkit/command/TabCommandExecutor.java b/src/main/java/org/bukkit/command/TabCommandExecutor.java
index 95efbd40..bf6ddd4e 100644
--- a/src/main/java/org/bukkit/command/TabCommandExecutor.java
+++ b/src/main/java/org/bukkit/command/TabCommandExecutor.java
@@ -4,6 +4,7 @@
/**
* Represents a class which can handle command tab completion and commands
+ *
* @deprecated Remains for plugins that would have implemented it even without functionality
* @see TabExecutor
*/
diff --git a/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java b/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java
index c60ff56e..81432139 100644
--- a/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java
+++ b/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java
@@ -5,6 +5,7 @@
*/
@SuppressWarnings("serial")
public class InvalidConfigurationException extends Exception {
+
/**
* Creates a new instance of InvalidConfigurationException without a message or cause.
*/
diff --git a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java
index 7eb01549..7bf4b299 100644
--- a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java
+++ b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java
@@ -16,10 +16,12 @@
*
* In addition to implementing this interface, you must register the class with
* {@link ConfigurationSerialization#registerClass(Class)}.
+ *
* @see DelegateDeserialization
* @see SerializableAs
*/
public interface ConfigurationSerializable {
+
/**
* Creates a Map representation of this class.
*
diff --git a/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java b/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java index db69dfc8..4612ab3a 100644 --- a/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java +++ b/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java @@ -15,6 +15,7 @@ *
* Using this annotation on any other class than a {@link ConfigurationSerializable} will * have no effect. + * * @see ConfigurationSerialization#registerClass(Class, String) */ @Retention(RetentionPolicy.RUNTIME) diff --git a/src/main/java/org/bukkit/entity/AnimalTamer.java b/src/main/java/org/bukkit/entity/AnimalTamer.java index 89a77148..a80d31aa 100644 --- a/src/main/java/org/bukkit/entity/AnimalTamer.java +++ b/src/main/java/org/bukkit/entity/AnimalTamer.java @@ -1,6 +1,7 @@ package org.bukkit.entity; public interface AnimalTamer { + /** * This is the name of the specified AnimalTamer. * diff --git a/src/main/java/org/bukkit/entity/ComplexEntityPart.java b/src/main/java/org/bukkit/entity/ComplexEntityPart.java index 5db43e0a..f4ab0bbd 100644 --- a/src/main/java/org/bukkit/entity/ComplexEntityPart.java +++ b/src/main/java/org/bukkit/entity/ComplexEntityPart.java @@ -4,6 +4,7 @@ * Represents a single part of a {@link ComplexLivingEntity} */ public interface ComplexEntityPart extends Entity { + /** * Gets the parent {@link ComplexLivingEntity} of this part. * diff --git a/src/main/java/org/bukkit/entity/EntityType.java b/src/main/java/org/bukkit/entity/EntityType.java index 6e049e94..9f9196a7 100644 --- a/src/main/java/org/bukkit/entity/EntityType.java +++ b/src/main/java/org/bukkit/entity/EntityType.java @@ -14,10 +14,11 @@ import org.bukkit.World; public enum EntityType { + // These strings MUST match the strings in nms.EntityTypes and are case sensitive. /** * An item resting on the ground. - * + *
* Spawn with {@link World#dropItem(Location, ItemStack)} * or {@link World#dropItemNaturally(Location, ItemStack)} */ diff --git a/src/main/java/org/bukkit/entity/ExperienceOrb.java b/src/main/java/org/bukkit/entity/ExperienceOrb.java index 40783b89..c286edfd 100644 --- a/src/main/java/org/bukkit/entity/ExperienceOrb.java +++ b/src/main/java/org/bukkit/entity/ExperienceOrb.java @@ -4,6 +4,7 @@ * Represents an Experience Orb. */ public interface ExperienceOrb extends Entity { + /** * Gets how much experience is contained within this orb * diff --git a/src/main/java/org/bukkit/entity/Explosive.java b/src/main/java/org/bukkit/entity/Explosive.java index bc68190c..48650f6a 100644 --- a/src/main/java/org/bukkit/entity/Explosive.java +++ b/src/main/java/org/bukkit/entity/Explosive.java @@ -4,6 +4,7 @@ * A representation of an explosive entity */ public interface Explosive extends Entity { + /** * Set the radius affected by this explosive's explosion * diff --git a/src/main/java/org/bukkit/entity/FallingBlock.java b/src/main/java/org/bukkit/entity/FallingBlock.java index 41fca566..1e3f4dec 100644 --- a/src/main/java/org/bukkit/entity/FallingBlock.java +++ b/src/main/java/org/bukkit/entity/FallingBlock.java @@ -6,6 +6,7 @@ * Represents a falling block */ public interface FallingBlock extends Entity { + /** * Get the Material of the falling block * diff --git a/src/main/java/org/bukkit/entity/Fireball.java b/src/main/java/org/bukkit/entity/Fireball.java index 95c60f8b..88876a47 100644 --- a/src/main/java/org/bukkit/entity/Fireball.java +++ b/src/main/java/org/bukkit/entity/Fireball.java @@ -6,6 +6,7 @@ * Represents a Fireball. */ public interface Fireball extends Projectile, Explosive { + /** * Fireballs fly straight and do not take setVelocity(...) well. * diff --git a/src/main/java/org/bukkit/entity/Firework.java b/src/main/java/org/bukkit/entity/Firework.java index b6138192..cd03b2f3 100644 --- a/src/main/java/org/bukkit/entity/Firework.java +++ b/src/main/java/org/bukkit/entity/Firework.java @@ -3,6 +3,7 @@ import org.bukkit.inventory.meta.FireworkMeta; public interface Firework extends Entity { + /** * Get a copy of the fireworks meta * diff --git a/src/main/java/org/bukkit/entity/Ocelot.java b/src/main/java/org/bukkit/entity/Ocelot.java index fd6151b1..ea1f64d7 100644 --- a/src/main/java/org/bukkit/entity/Ocelot.java +++ b/src/main/java/org/bukkit/entity/Ocelot.java @@ -5,6 +5,7 @@ * A wild tameable cat */ public interface Ocelot extends Animals, Tameable { + /** * Gets the current type of this cat. * diff --git a/src/main/java/org/bukkit/entity/Painting.java b/src/main/java/org/bukkit/entity/Painting.java index 3326a9fe..ddfa89d3 100644 --- a/src/main/java/org/bukkit/entity/Painting.java +++ b/src/main/java/org/bukkit/entity/Painting.java @@ -7,6 +7,7 @@ * Represents a Painting. */ public interface Painting extends Hanging { + /** * Get the art on this painting * diff --git a/src/main/java/org/bukkit/entity/PigZombie.java b/src/main/java/org/bukkit/entity/PigZombie.java index f8b1fb73..65a3f8cd 100644 --- a/src/main/java/org/bukkit/entity/PigZombie.java +++ b/src/main/java/org/bukkit/entity/PigZombie.java @@ -4,6 +4,7 @@ * Represents a Pig Zombie. */ public interface PigZombie extends Zombie { + /** * Get the pig zombie's current anger level. * diff --git a/src/main/java/org/bukkit/entity/Skeleton.java b/src/main/java/org/bukkit/entity/Skeleton.java index c91b1039..102304df 100644 --- a/src/main/java/org/bukkit/entity/Skeleton.java +++ b/src/main/java/org/bukkit/entity/Skeleton.java @@ -4,6 +4,7 @@ * Represents a Skeleton. */ public interface Skeleton extends Monster { + /** * Gets the current type of this skeleton. * diff --git a/src/main/java/org/bukkit/entity/TNTPrimed.java b/src/main/java/org/bukkit/entity/TNTPrimed.java index 3b5952c8..295dcb9b 100644 --- a/src/main/java/org/bukkit/entity/TNTPrimed.java +++ b/src/main/java/org/bukkit/entity/TNTPrimed.java @@ -4,6 +4,7 @@ * Represents a Primed TNT. */ public interface TNTPrimed extends Explosive { + /** * Set the number of ticks until the TNT blows up after being primed. * diff --git a/src/main/java/org/bukkit/entity/Villager.java b/src/main/java/org/bukkit/entity/Villager.java index f6f90cc1..62a36a42 100644 --- a/src/main/java/org/bukkit/entity/Villager.java +++ b/src/main/java/org/bukkit/entity/Villager.java @@ -4,6 +4,7 @@ * Represents a villager NPC */ public interface Villager extends Ageable, NPC { + /** * Gets the current profession of this villager. * diff --git a/src/main/java/org/bukkit/entity/Zombie.java b/src/main/java/org/bukkit/entity/Zombie.java index 7f1ffd19..59b52fd3 100644 --- a/src/main/java/org/bukkit/entity/Zombie.java +++ b/src/main/java/org/bukkit/entity/Zombie.java @@ -4,6 +4,7 @@ * Represents a Zombie. */ public interface Zombie extends Monster { + /** * Gets whether the zombie is a baby * diff --git a/src/main/java/org/bukkit/event/Cancellable.java b/src/main/java/org/bukkit/event/Cancellable.java index 3fc13fc8..799b0b0f 100644 --- a/src/main/java/org/bukkit/event/Cancellable.java +++ b/src/main/java/org/bukkit/event/Cancellable.java @@ -1,6 +1,7 @@ package org.bukkit.event; public interface Cancellable { + /** * Gets the cancellation state of this event. A cancelled event will not * be executed in the server, but will still pass to other plugins diff --git a/src/main/java/org/bukkit/event/EventPriority.java b/src/main/java/org/bukkit/event/EventPriority.java index d087dec9..eb1400e0 100644 --- a/src/main/java/org/bukkit/event/EventPriority.java +++ b/src/main/java/org/bukkit/event/EventPriority.java @@ -4,6 +4,7 @@ * Represents an event's priority in execution */ public enum EventPriority { + /** * Event call is of very low importance and should be ran first, to allow * other plugins to further customise the outcome diff --git a/src/main/java/org/bukkit/event/HandlerList.java b/src/main/java/org/bukkit/event/HandlerList.java index f6d9014e..4b97a71b 100644 --- a/src/main/java/org/bukkit/event/HandlerList.java +++ b/src/main/java/org/bukkit/event/HandlerList.java @@ -10,6 +10,7 @@ * A list of event handlers, stored per-event. Based on lahwran's fevents. */ public class HandlerList { + /** * Handler array. This field being an array is the key to this system's speed. */ diff --git a/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java b/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java index 7eed8ad4..c84bda9e 100644 --- a/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java @@ -3,6 +3,9 @@ import org.bukkit.block.Block; import org.bukkit.entity.Entity; +/** + * Called when a block causes an entity to combust. + */ public class EntityCombustByBlockEvent extends EntityCombustEvent { private final Block combuster; diff --git a/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java b/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java index 84ca5c20..639567bd 100644 --- a/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java @@ -2,6 +2,9 @@ import org.bukkit.entity.Entity; +/** + * Called when an entity causes another entity to combust. + */ public class EntityCombustByEntityEvent extends EntityCombustEvent { private final Entity combuster; diff --git a/src/main/java/org/bukkit/event/entity/ItemDespawnEvent.java b/src/main/java/org/bukkit/event/entity/ItemDespawnEvent.java index 6f4533c0..315b1e50 100644 --- a/src/main/java/org/bukkit/event/entity/ItemDespawnEvent.java +++ b/src/main/java/org/bukkit/event/entity/ItemDespawnEvent.java @@ -5,6 +5,9 @@ import org.bukkit.event.Cancellable; import org.bukkit.event.HandlerList; +/** + * Called when an item de-spawns from the world. + */ public class ItemDespawnEvent extends EntityEvent implements Cancellable { private static final HandlerList handlers = new HandlerList(); private boolean canceled; diff --git a/src/main/java/org/bukkit/event/inventory/ClickType.java b/src/main/java/org/bukkit/event/inventory/ClickType.java index dc2928cc..c9e447fa 100644 --- a/src/main/java/org/bukkit/event/inventory/ClickType.java +++ b/src/main/java/org/bukkit/event/inventory/ClickType.java @@ -4,6 +4,7 @@ * What the client did to trigger this action (not the result). */ public enum ClickType { + /** * The left (or primary) mouse button. */ diff --git a/src/main/java/org/bukkit/event/inventory/CraftItemEvent.java b/src/main/java/org/bukkit/event/inventory/CraftItemEvent.java index 4ebc36bd..ba3f5e5f 100644 --- a/src/main/java/org/bukkit/event/inventory/CraftItemEvent.java +++ b/src/main/java/org/bukkit/event/inventory/CraftItemEvent.java @@ -5,6 +5,9 @@ import org.bukkit.inventory.InventoryView; import org.bukkit.inventory.Recipe; +/** + * Called when the recipe of an Item is completed inside a crafting matrix. + */ public class CraftItemEvent extends InventoryClickEvent { private Recipe recipe; diff --git a/src/main/java/org/bukkit/event/inventory/InventoryAction.java b/src/main/java/org/bukkit/event/inventory/InventoryAction.java index c9da0222..dbdbe26c 100644 --- a/src/main/java/org/bukkit/event/inventory/InventoryAction.java +++ b/src/main/java/org/bukkit/event/inventory/InventoryAction.java @@ -4,8 +4,10 @@ * An estimation of what the result will be. */ public enum InventoryAction { + /** * Nothing will happen from the click. + *
* There may be cases where nothing will happen and this is value is * not provided, but it is guaranteed that this value is accurate * when given. diff --git a/src/main/java/org/bukkit/event/inventory/InventoryType.java b/src/main/java/org/bukkit/event/inventory/InventoryType.java index 87edc427..06cabcd5 100644 --- a/src/main/java/org/bukkit/event/inventory/InventoryType.java +++ b/src/main/java/org/bukkit/event/inventory/InventoryType.java @@ -1,6 +1,7 @@ package org.bukkit.event.inventory; public enum InventoryType { + /** * A chest inventory, with 0, 9, 18, 27, 36, 45, or 54 slots of type CONTAINER. */ diff --git a/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java b/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java index e1726a2d..d32c55e4 100644 --- a/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java @@ -7,6 +7,9 @@ import org.bukkit.event.Cancellable; import org.bukkit.inventory.ItemStack; +/** + * Called when a player interacts with a Bucket + */ public abstract class PlayerBucketEvent extends PlayerEvent implements Cancellable { private ItemStack itemStack; private boolean cancelled = false; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java index d84faf45..eebfdb15 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java @@ -3,6 +3,9 @@ import org.bukkit.entity.Vehicle; import org.bukkit.event.HandlerList; +/** + * Called when a vehicle updates + */ public class VehicleUpdateEvent extends VehicleEvent { private static final HandlerList handlers = new HandlerList(); diff --git a/src/main/java/org/bukkit/generator/BlockPopulator.java b/src/main/java/org/bukkit/generator/BlockPopulator.java index 041dc4fc..eacc8294 100644 --- a/src/main/java/org/bukkit/generator/BlockPopulator.java +++ b/src/main/java/org/bukkit/generator/BlockPopulator.java @@ -9,6 +9,7 @@ * For example, generating glowstone inside the nether or generating dungeons full of treasure */ public abstract class BlockPopulator { + /** * Populates an area of blocks at or around the given chunk. *
diff --git a/src/main/java/org/bukkit/generator/ChunkGenerator.java b/src/main/java/org/bukkit/generator/ChunkGenerator.java index b43203d0..a53ec686 100644 --- a/src/main/java/org/bukkit/generator/ChunkGenerator.java +++ b/src/main/java/org/bukkit/generator/ChunkGenerator.java @@ -14,6 +14,7 @@ * For example, the nether chunk generator should shape netherrack and soulsand */ public abstract class ChunkGenerator { + /** * Interface to biome data for chunk to be generated: initialized with default values for world type and seed. *
diff --git a/src/main/java/org/bukkit/inventory/BeaconInventory.java b/src/main/java/org/bukkit/inventory/BeaconInventory.java index deaf183d..d791f604 100644 --- a/src/main/java/org/bukkit/inventory/BeaconInventory.java +++ b/src/main/java/org/bukkit/inventory/BeaconInventory.java @@ -1,6 +1,7 @@ package org.bukkit.inventory; public interface BeaconInventory extends Inventory { + /** * Set the item powering the beacon. * diff --git a/src/main/java/org/bukkit/inventory/BrewerInventory.java b/src/main/java/org/bukkit/inventory/BrewerInventory.java index 735e86d8..91cd276b 100644 --- a/src/main/java/org/bukkit/inventory/BrewerInventory.java +++ b/src/main/java/org/bukkit/inventory/BrewerInventory.java @@ -3,6 +3,7 @@ import org.bukkit.block.BrewingStand; public interface BrewerInventory extends Inventory { + /** * Get the current ingredient for brewing. * diff --git a/src/main/java/org/bukkit/inventory/CraftingInventory.java b/src/main/java/org/bukkit/inventory/CraftingInventory.java index 4b6cce44..e3b31b5e 100644 --- a/src/main/java/org/bukkit/inventory/CraftingInventory.java +++ b/src/main/java/org/bukkit/inventory/CraftingInventory.java @@ -4,6 +4,7 @@ * Interface to the crafting inventories */ public interface CraftingInventory extends Inventory { + /** * Check what item is in the result slot of this crafting inventory. * diff --git a/src/main/java/org/bukkit/inventory/DoubleChestInventory.java b/src/main/java/org/bukkit/inventory/DoubleChestInventory.java index 1a203205..0e419ed2 100644 --- a/src/main/java/org/bukkit/inventory/DoubleChestInventory.java +++ b/src/main/java/org/bukkit/inventory/DoubleChestInventory.java @@ -3,6 +3,7 @@ import org.bukkit.block.DoubleChest; public interface DoubleChestInventory extends Inventory { + /** * Get the left half of this double chest. * diff --git a/src/main/java/org/bukkit/inventory/EnchantingInventory.java b/src/main/java/org/bukkit/inventory/EnchantingInventory.java index f1587330..9be1ee7f 100644 --- a/src/main/java/org/bukkit/inventory/EnchantingInventory.java +++ b/src/main/java/org/bukkit/inventory/EnchantingInventory.java @@ -1,6 +1,7 @@ package org.bukkit.inventory; public interface EnchantingInventory extends Inventory { + /** * Set the item being enchanted. * diff --git a/src/main/java/org/bukkit/inventory/EntityEquipment.java b/src/main/java/org/bukkit/inventory/EntityEquipment.java index 01c35287..de682a66 100644 --- a/src/main/java/org/bukkit/inventory/EntityEquipment.java +++ b/src/main/java/org/bukkit/inventory/EntityEquipment.java @@ -6,6 +6,7 @@ * An interface to a creatures inventory */ public interface EntityEquipment { + /** * Gets a copy of the item the entity is currently holding * diff --git a/src/main/java/org/bukkit/inventory/FurnaceInventory.java b/src/main/java/org/bukkit/inventory/FurnaceInventory.java index f2219a65..5920083a 100644 --- a/src/main/java/org/bukkit/inventory/FurnaceInventory.java +++ b/src/main/java/org/bukkit/inventory/FurnaceInventory.java @@ -3,6 +3,7 @@ import org.bukkit.block.Furnace; public interface FurnaceInventory extends Inventory { + /** * Get the current item in the result slot. * diff --git a/src/main/java/org/bukkit/inventory/InventoryHolder.java b/src/main/java/org/bukkit/inventory/InventoryHolder.java index 9d788438..9c06a3d7 100644 --- a/src/main/java/org/bukkit/inventory/InventoryHolder.java +++ b/src/main/java/org/bukkit/inventory/InventoryHolder.java @@ -1,6 +1,7 @@ package org.bukkit.inventory; public interface InventoryHolder { + /** * Get the object's inventory. * diff --git a/src/main/java/org/bukkit/permissions/Permissible.java b/src/main/java/org/bukkit/permissions/Permissible.java index e094f069..66a0c810 100644 --- a/src/main/java/org/bukkit/permissions/Permissible.java +++ b/src/main/java/org/bukkit/permissions/Permissible.java @@ -7,6 +7,7 @@ * Represents an object that may be assigned permissions */ public interface Permissible extends ServerOperator { + /** * Checks if this object contains an override for the specified permission, by fully qualified name * diff --git a/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java b/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java index a9543cf8..aa797eec 100644 --- a/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java +++ b/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java @@ -4,6 +4,7 @@ * Represents a class which is to be notified when a {@link PermissionAttachment} is removed from a {@link Permissible} */ public interface PermissionRemovedExecutor { + /** * Called when a {@link PermissionAttachment} is removed from a {@link Permissible} * diff --git a/src/main/java/org/bukkit/permissions/ServerOperator.java b/src/main/java/org/bukkit/permissions/ServerOperator.java index 721c42a3..e4faa87f 100644 --- a/src/main/java/org/bukkit/permissions/ServerOperator.java +++ b/src/main/java/org/bukkit/permissions/ServerOperator.java @@ -6,6 +6,7 @@ * Represents an object that may become a server operator, such as a {@link Player} */ public interface ServerOperator { + /** * Checks if this object is a server operator * diff --git a/src/main/java/org/bukkit/potion/Potion.java b/src/main/java/org/bukkit/potion/Potion.java index bcfa4488..43c18ac4 100644 --- a/src/main/java/org/bukkit/potion/Potion.java +++ b/src/main/java/org/bukkit/potion/Potion.java @@ -37,7 +37,9 @@ public Potion(PotionType type) { } } - /** @deprecated In favour of {@link #Potion(PotionType, int)} */ + /** + * @deprecated In favour of {@link #Potion(PotionType, int)} + */ @SuppressWarnings("javadoc") @Deprecated public Potion(PotionType type, Tier tier) { @@ -45,14 +47,18 @@ public Potion(PotionType type, Tier tier) { Validate.notNull(type, "Type cannot be null"); } - /** @deprecated In favour of {@link #Potion(PotionType, int, boolean)} */ + /** + * @deprecated In favour of {@link #Potion(PotionType, int, boolean)} + */ @SuppressWarnings("javadoc") @Deprecated public Potion(PotionType type, Tier tier, boolean splash) { this(type, tier == Tier.TWO ? 2 : 1, splash); } - /** @deprecated In favour of {@link #Potion(PotionType, int, boolean, boolean)} */ + /** + * @deprecated In favour of {@link #Potion(PotionType, int, boolean, boolean)} + */ @SuppressWarnings("javadoc") @Deprecated public Potion(PotionType type, Tier tier, boolean splash, boolean extended) { diff --git a/src/main/java/org/bukkit/potion/PotionBrewer.java b/src/main/java/org/bukkit/potion/PotionBrewer.java index 7d8318cf..91b6b28c 100644 --- a/src/main/java/org/bukkit/potion/PotionBrewer.java +++ b/src/main/java/org/bukkit/potion/PotionBrewer.java @@ -6,6 +6,7 @@ * Represents a brewer that can create {@link PotionEffect}s. */ public interface PotionBrewer { + /** * Creates a {@link PotionEffect} from the given {@link PotionEffectType}, * applying duration modifiers and checks. diff --git a/src/main/java/org/bukkit/scheduler/BukkitTask.java b/src/main/java/org/bukkit/scheduler/BukkitTask.java index 890c7315..e447e64e 100644 --- a/src/main/java/org/bukkit/scheduler/BukkitTask.java +++ b/src/main/java/org/bukkit/scheduler/BukkitTask.java @@ -5,7 +5,6 @@ /** * Represents a task being executed by the scheduler */ - public interface BukkitTask { /** diff --git a/src/main/java/org/bukkit/scheduler/BukkitWorker.java b/src/main/java/org/bukkit/scheduler/BukkitWorker.java index a889e893..4df43a6a 100644 --- a/src/main/java/org/bukkit/scheduler/BukkitWorker.java +++ b/src/main/java/org/bukkit/scheduler/BukkitWorker.java @@ -8,7 +8,6 @@ *
* Workers are used to execute async tasks. */ - public interface BukkitWorker { /** diff --git a/src/main/java/org/bukkit/util/FileUtil.java b/src/main/java/org/bukkit/util/FileUtil.java index 2e137675..7cabf4c5 100644 --- a/src/main/java/org/bukkit/util/FileUtil.java +++ b/src/main/java/org/bukkit/util/FileUtil.java @@ -9,7 +9,6 @@ /** * Class containing file utilities */ - public class FileUtil { /** @@ -19,7 +18,6 @@ public class FileUtil { * @param outFile the target filename * @return true on success */ - public static boolean copy(File inFile, File outFile) { if (!inFile.exists()) { return false;