Javadoc updates

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

By: feildmaster <admin@feildmaster.com>

paper-api/src/main/java/org/bukkit/block/Block.java

@@ -35,8 +35,8 @@ public interface Block extends Metadatable {
     Block getRelative(int modX, int modY, int modZ);
 
     /**
-     * Gets the block at the given face<br />
-     * <br />
+     * Gets the block at the given face
+     * <p />
      * This method is equal to getRelative(face, 1)
      *
      * @param face Face of this block to return
@@ -46,14 +46,14 @@ public interface Block extends Metadatable {
     Block getRelative(BlockFace face);
 
     /**
-     * Gets the block at the given distance of the given face<br />
-     * <br />
+     * Gets the block at the given distance of the given face
+     * <p />
      * For example, the following method places water at 100,102,100; two blocks
      * above 100,100,100.
      *
      * <pre>
      * Block block = world.getBlockAt(100, 100, 100);
-     * Block shower = block.getFace(BlockFace.UP, 2);
+     * Block shower = block.getRelative(BlockFace.UP, 2);
      * shower.setType(Material.WATER);
      * </pre>
      *
@@ -86,7 +86,7 @@ public interface Block extends Metadatable {
 
     /**
      * Get the amount of light at this block from the sky.
-     * <p>
+     * <p />
      * Any light given from other sources (such as blocks like torches) will be ignored.
      *
      * @return Sky light level
@@ -95,7 +95,7 @@ public interface Block extends Metadatable {
 
     /**
      * Get the amount of light at this block from nearby blocks.
-     * <p>
+     * <p />
      * Any light given from other sources (such as the sun) will be ignored.
      *
      * @return Block light level
@@ -194,17 +194,15 @@ public interface Block extends Metadatable {
     boolean setTypeIdAndData(int type, byte data, boolean applyPhysics);
 
     /**
-     * Gets the face relation of this block compared to the given block<br />
-     * <br />
+     * Gets the face relation of this block compared to the given block
+     * <p />
      * For example:
-     *
      * <pre>
      * Block current = world.getBlockAt(100, 100, 100);
      * Block target = world.getBlockAt(100, 101, 100);
      *
      * current.getFace(target) == BlockFace.Up;
      * </pre>
-     *
      * <br />
      * If the given block is not connected to this block, null may be returned
      *

paper-api/src/main/java/org/bukkit/block/Dispenser.java

@@ -6,8 +6,8 @@ package org.bukkit.block;
 public interface Dispenser extends BlockState, ContainerBlock {
 
     /**
-     * Attempts to dispense the contents of this block<br />
-     * <br />
+     * Attempts to dispense the contents of this block
+     * <p />
      * If the block is no longer a dispenser, this will return false
      *
      * @return true if successful, otherwise false

paper-api/src/main/java/org/bukkit/block/NoteBlock.java

@@ -37,8 +37,8 @@ public interface NoteBlock extends BlockState {
     public void setRawNote(byte note);
 
     /**
-     * Attempts to play the note at block<br />
-     * <br />
+     * Attempts to play the note at block
+     * <p />
      * If the block is no longer a note block, this will return false
      *
      * @return true if successful, otherwise false