Javadoc updates

Fixes BUKKIT-1653, Fixes BUKKIT-1383 and Fixes BUKKIT-1644

By: feildmaster <admin@feildmaster.com>

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

@@ -27,7 +27,7 @@ public interface Inventory extends Iterable<ItemStack> {
 
     /**
      * This method allows you to change the maximum stack size for an inventory.
-     * <p><b>Caveats:</b>
+     * <p /><b>Caveats:</b>
      * <ul>
      * <li>Not all inventories respect this value.
      * <li>Stacks larger than 127 may be clipped when the world is saved.
@@ -205,7 +205,7 @@ public interface Inventory extends Iterable<ItemStack> {
     /**
      * Find the first empty Slot.
      *
-     * @return The first empty Slot found.
+     * @return The first empty Slot found, or -1 if no empty slots.
      */
     public int firstEmpty();
 

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

@@ -88,7 +88,7 @@ public abstract class InventoryView {
 
     /**
      * Sets one item in this inventory view by its raw slot ID.
-     * <p>
+     * <p />
      * Note: If slot ID -999 is chosen, it may be expected that the item is
      * dropped on the ground. This is not required behaviour, however.
      * @param slot The ID as returned by InventoryClickEvent.getRawSlot()

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

@@ -77,8 +77,8 @@ public class ItemStack implements Cloneable, ConfigurationSerializable {
     }
 
     /**
-     * Sets the type of this item<br />
-     * <br />
+     * Sets the type of this item
+     * <p />
      * Note that in doing so you will reset the MaterialData for this stack
      *
      * @param type New type to set the items in this stack to
@@ -97,8 +97,8 @@ public class ItemStack implements Cloneable, ConfigurationSerializable {
     }
 
     /**
-     * Sets the type id of this item<br />
-     * <br />
+     * Sets the type id of this item
+     * <p />
      * Note that in doing so you will reset the MaterialData for this stack
      *
      * @param type New type id to set the items in this stack to
@@ -274,7 +274,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable {
 
     /**
      * Adds the specified enchantments to this item stack.
-     * <p>
+     * <p />
      * This method is the same as calling {@link #addEnchantment(org.bukkit.enchantments.Enchantment, int)}
      * for each element of the map.
      *
@@ -288,7 +288,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable {
 
     /**
      * Adds the specified {@link Enchantment} to this item stack.
-     * <p>
+     * <p />
      * If this item stack already contained the given enchantment (at any level), it will be replaced.
      *
      * @param ench Enchantment to add
@@ -306,7 +306,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable {
 
     /**
      * Adds the specified enchantments to this item stack in an unsafe manner.
-     * <p>
+     * <p />
      * This method is the same as calling {@link #addUnsafeEnchantment(org.bukkit.enchantments.Enchantment, int)}
      * for each element of the map.
      *
@@ -320,9 +320,9 @@ public class ItemStack implements Cloneable, ConfigurationSerializable {
 
     /**
      * Adds the specified {@link Enchantment} to this item stack.
-     * <p>
+     * <p />
      * If this item stack already contained the given enchantment (at any level), it will be replaced.
-     * <p>
+     * <p />
      * This method is unsafe and will ignore level restrictions or item type. Use at your own
      * discretion.
      *