Java Doc for some Client events and helpful api (#242)

* doc

* doc

* doc

* Update IRenderHandler.java

src/main/java/net/minecraftforge/client/IRenderHandler.java

@@ -24,8 +24,19 @@
 import net.minecraft.client.Minecraft;
 import net.minecraft.client.multiplayer.WorldClient;
 
+/**
+ * Take over the rendering of world effects. For the vanilla, they are Cloud, Sky and Weather.
+ * <br><br/>
+ * Call <br>    {@link net.minecraft.world.WorldProvider#setCloudRenderer(IRenderHandler)}<br>   {@link net.minecraft.world.WorldProvider#setSkyRenderer(IRenderHandler)}<br>    {@link net.minecraft.world.WorldProvider#setWeatherRenderer(IRenderHandler)}
+ * to enable them.
+ */
 public abstract class IRenderHandler
 {
+    /**
+     * @param partialTicks Fractional part of a tick
+     * @param world the world being rendered
+     * @param mc Current mc instance
+     */
     @SideOnly(Side.CLIENT)
     public abstract void render(float partialTicks, WorldClient world, Minecraft mc);
 }

src/main/java/net/minecraftforge/client/event/ClientChatReceivedEvent.java

@@ -24,6 +24,22 @@
 import net.minecraftforge.fml.common.eventhandler.Cancelable;
 import net.minecraftforge.fml.common.eventhandler.Event;
 
+/**
+ * ClientChatReceivedEvent is fired whenever the client received a chat message. <br>
+ * This event is fired via {@link net.minecraftforge.event.ForgeEventFactory#onClientChat(ChatType, ITextComponent)},
+ * which is executed by {@link net.minecraft.client.network.NetHandlerPlayClient#handleChat(net.minecraft.network.play.server.SPacketChat)}<br>
+ * <br>
+ * {@link #message} contains the message that will be displayed. This can be changed by mods.<br>
+ * <br>
+ * {@link #type} is the type of the message. This field is read only.<br>
+ * <br>
+ * This event is {@link Cancelable}. <br>
+ * If this event is canceled, the chat message will be ignored and not displayed.<br>
+ * <br>
+ * This event does not have a result. {@link HasResult}<br>
+ * <br>
+ * This event is fired on the {@link net.minecraftforge.common.MinecraftForge#EVENT_BUS}.
+ **/
 @Cancelable
 public class ClientChatReceivedEvent extends Event
 {

src/main/java/net/minecraftforge/client/event/RenderLivingEvent.java

@@ -24,6 +24,14 @@
 import net.minecraft.client.renderer.entity.RenderLivingBase;
 import net.minecraft.entity.EntityLivingBase;
 
+/**
+ * RenderLivingEvent is fired whenever the client is about to render a living.<br>
+ * If a method utilizes this {@link Event} as its parameter, the method will receive every child event of this class.
+ * <br>
+ * All children of this event are fired on the {@link net.minecraftforge.common.MinecraftForge#EVENT_BUS}.<br>
+ *
+ * @param <T> the type of the living.
+ **/
 public abstract class RenderLivingEvent<T extends EntityLivingBase> extends Event
 {
     private final EntityLivingBase entity;
@@ -70,6 +78,12 @@ public static class Post<T extends EntityLivingBase> extends RenderLivingEvent<T
         public Post(EntityLivingBase entity, RenderLivingBase<T> renderer, float partialRenderTick, double x, double y, double z){ super(entity, renderer, partialRenderTick, x, y, z); }
     }
 
+    /**
+     * Specials is fired when the living draws the name <br>
+     * This event is fired via {@link RenderLivingBase#renderName(EntityLivingBase, double, double, double)},
+     * <br>
+     * This event is fired on the {@link net.minecraftforge.common.MinecraftForge#EVENT_BUS}.
+     **/
     public abstract static class Specials<T extends EntityLivingBase> extends RenderLivingEvent<T>
     {
         public Specials(EntityLivingBase entity, RenderLivingBase<T> renderer, double x, double y, double z){ super(entity, renderer, 0, x, y, z); }

src/main/java/net/minecraftforge/client/event/RenderPlayerEvent.java

@@ -27,6 +27,12 @@
 
 import javax.annotation.Nonnull;
 
+/**
+ * RenderLivingEvent is fired whenever the client is about to render a player.<br>
+ * When the rendered target is not the local user, {@link RenderLivingEvent} will be fired if {@link Pre} is not cancelled.
+ * <br>
+ * All children of this event are fired on the {@link net.minecraftforge.common.MinecraftForge#EVENT_BUS}.<br>
+ **/
 public abstract class RenderPlayerEvent extends PlayerEvent
 {
     private final RenderPlayer renderer;

src/main/java/net/minecraftforge/client/event/sound/SoundEvent.java

@@ -23,6 +23,11 @@
 import net.minecraft.client.audio.ISound;
 import net.minecraft.client.audio.SoundManager;
 
+/**
+ * SoundEvent is fired when an event involving any Sound occurs.<br>
+ * <br>
+ * All children of this event are fired on the {@link net.minecraftforge.common.MinecraftForge#EVENT_BUS}.<br>
+ **/
 public class SoundEvent extends Event
 {
     private final SoundManager manager;
@@ -36,6 +41,9 @@ public SoundManager getManager()
         return manager;
     }
 
+    /**
+     * When a new sound source is passed to the SoundSystem
+     */
     public static class SoundSourceEvent extends SoundEvent
     {
         private final ISound sound;