Pulling all pending Bukkit-JavaDoc changes

By: Wesley Wolfe <weswolf@aol.com>

paper-api/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.
      *

paper-api/src/main/java/org/bukkit/inventory/BrewerInventory.java

@@ -3,6 +3,7 @@ package org.bukkit.inventory;
 import org.bukkit.block.BrewingStand;
 
 public interface BrewerInventory extends Inventory {
+
     /**
      * Get the current ingredient for brewing.
      *

paper-api/src/main/java/org/bukkit/inventory/CraftingInventory.java

@@ -4,6 +4,7 @@ package org.bukkit.inventory;
  * Interface to the crafting inventories
  */
 public interface CraftingInventory extends Inventory {
+
     /**
      * Check what item is in the result slot of this crafting inventory.
      *

paper-api/src/main/java/org/bukkit/inventory/DoubleChestInventory.java

@@ -3,6 +3,7 @@ package org.bukkit.inventory;
 import org.bukkit.block.DoubleChest;
 
 public interface DoubleChestInventory extends Inventory {
+
     /**
      * Get the left half of this double chest.
      *

paper-api/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.
      *

paper-api/src/main/java/org/bukkit/inventory/EntityEquipment.java

@@ -6,6 +6,7 @@ import org.bukkit.entity.Entity;
  * An interface to a creatures inventory
  */
 public interface EntityEquipment {
+
     /**
      * Gets a copy of the item the entity is currently holding
      *

paper-api/src/main/java/org/bukkit/inventory/FurnaceInventory.java

@@ -3,6 +3,7 @@ package org.bukkit.inventory;
 import org.bukkit.block.Furnace;
 
 public interface FurnaceInventory extends Inventory {
+
     /**
      * Get the current item in the result slot.
      *

paper-api/src/main/java/org/bukkit/inventory/Inventory.java

@@ -171,21 +171,28 @@ public interface Inventory extends Iterable<ItemStack> {
     public boolean contains(Material material, int amount) throws IllegalArgumentException;
 
     /**
-     * Checks if the inventory contains any ItemStacks matching the given ItemStack and at least the minimum amount specified
-     * This will only match if both the type and the amount of the stack match
+     * Checks if the inventory contains at least the minimum amount specified
+     * of exactly matching ItemStacks.
+     * <p>
+     * An ItemStack only counts if both the type and the amount of the stack
+     * match.
      *
-     * @param item The ItemStack to match against
-     * @param amount The amount of stacks to find
-     * @return false if item is null, true if amount less than 1, true if amount of exactly matching ItemStacks were found.
+     * @param item the ItemStack to match against
+     * @param amount how many identical stacks to check for
+     * @return false if item is null, true if amount less than 1, true if
+     *     amount of exactly matching ItemStacks were found
+     * @see #containsAtLeast(ItemStack, int)
      */
     public boolean contains(ItemStack item, int amount);
 
     /**
-     * Checks if the inventory contains any ItemStacks matching the given ItemStack and at least the minimum amount specified
+     * Checks if the inventory contains ItemStacks matching the given
+     * ItemStack whose amounts sum to at least the minimum amount specified.
      *
-     * @param item The ItemStack to match against
-     * @param amount The minimum amount
-     * @return false if item is null, true if amount less than 1, true if enough ItemStacks were found to add to the given amount
+     * @param item the ItemStack to match against
+     * @param amount the minimum amount
+     * @return false if item is null, true if amount less than 1, true if
+     *     enough ItemStacks were found to add to the given amount
      */
     public boolean containsAtLeast(ItemStack item, int amount);
 

paper-api/src/main/java/org/bukkit/inventory/InventoryHolder.java

@@ -1,6 +1,7 @@
 package org.bukkit.inventory;
 
 public interface InventoryHolder {
+
     /**
      * Get the object's inventory.
      *