More JavaDoc improvements.

src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java

@@ -2,17 +2,16 @@ package org.bukkit.event.player;
 
 import org.bukkit.entity.Player;
 
-/*
+/**
  * Represents a player animation event
  */
 public class PlayerAnimationEvent extends PlayerEvent {
 
     private PlayerAnimationType animationType;
 
-    /*
-     * Construct a new event
+    /**
+     * Construct a new PlayerAnimation event
      *
-     * @param type The event type
      * @param player The player instance
      */
     public PlayerAnimationEvent(final Player player) {
@@ -22,10 +21,10 @@ public class PlayerAnimationEvent extends PlayerEvent {
         animationType = PlayerAnimationType.ARM_SWING;
     }
 
-    /*
+    /**
      * Get the type of this animation event
      *
-     * @returns the animation type
+     * @return the animation type
      */
     public PlayerAnimationType getAnimationType() {
         return animationType;