Document the delegate events.

Fixes WORLDGUARD-3164.

src/main/java/com/sk89q/worldguard/bukkit/event/DelegateEvent.java

@@ -27,6 +27,10 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ */
 public abstract class DelegateEvent extends Event implements Cancellable {
 
     @Nullable

src/main/java/com/sk89q/worldguard/bukkit/event/DelegateEvents.java

@@ -19,6 +19,9 @@
 
 package com.sk89q.worldguard.bukkit.event;
 
+/**
+ * Utility methods for dealing with delegate events.
+ */
 public final class DelegateEvents {
 
     private DelegateEvents() {

src/main/java/com/sk89q/worldguard/bukkit/event/block/AbstractBlockEvent.java

@@ -36,6 +36,10 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ */
 abstract class AbstractBlockEvent extends DelegateEvent implements BulkEvent {
 
     private final World world;

src/main/java/com/sk89q/worldguard/bukkit/event/block/BreakBlockEvent.java

@@ -30,6 +30,12 @@
 import javax.annotation.Nullable;
 import java.util.List;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when a block is broken.</p>
+ */
 public class BreakBlockEvent extends AbstractBlockEvent {
 
     private static final HandlerList handlers = new HandlerList();

src/main/java/com/sk89q/worldguard/bukkit/event/block/PlaceBlockEvent.java

@@ -30,6 +30,12 @@
 import javax.annotation.Nullable;
 import java.util.List;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when a block is placed.</p>
+ */
 public class PlaceBlockEvent extends AbstractBlockEvent {
 
     private static final HandlerList handlers = new HandlerList();

src/main/java/com/sk89q/worldguard/bukkit/event/block/UseBlockEvent.java

@@ -31,7 +31,10 @@
 import java.util.List;
 
 /**
- * Fired when a block is interacted with.
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when a block is interacted with.</p>
  */
 public class UseBlockEvent extends AbstractBlockEvent {
 

src/main/java/com/sk89q/worldguard/bukkit/event/entity/AbstractEntityEvent.java

@@ -31,6 +31,10 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ */
 abstract class AbstractEntityEvent extends DelegateEvent {
 
     private final Location target;

src/main/java/com/sk89q/worldguard/bukkit/event/entity/DamageEntityEvent.java

@@ -29,6 +29,12 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when an entity is damaged.</p>
+ */
 public class DamageEntityEvent extends AbstractEntityEvent {
 
     private static final HandlerList handlers = new HandlerList();

src/main/java/com/sk89q/worldguard/bukkit/event/entity/DestroyEntityEvent.java

@@ -29,6 +29,12 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when an entity is removed.</p>
+ */
 public class DestroyEntityEvent extends AbstractEntityEvent {
 
     private static final HandlerList handlers = new HandlerList();

src/main/java/com/sk89q/worldguard/bukkit/event/entity/SpawnEntityEvent.java

@@ -30,6 +30,12 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when an entity is spawned.</p>
+ */
 public class SpawnEntityEvent extends AbstractEntityEvent {
 
     private static final HandlerList handlers = new HandlerList();

src/main/java/com/sk89q/worldguard/bukkit/event/entity/UseEntityEvent.java

@@ -30,7 +30,10 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 
 /**
- * Fired when an entity is interacted with.
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when an entity is used.</p>
  */
 public class UseEntityEvent extends AbstractEntityEvent {
 

src/main/java/com/sk89q/worldguard/bukkit/event/inventory/UseItemEvent.java

@@ -31,7 +31,10 @@
 import static com.google.common.base.Preconditions.checkNotNull;
 
 /**
- * Fired when an item is interacted with.
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Thrown when an item is used.</p>
  */
 public class UseItemEvent extends DelegateEvent {
 

src/main/java/com/sk89q/worldguard/bukkit/event/player/ProcessPlayerEvent.java

@@ -25,6 +25,13 @@
 
 import static com.google.common.base.Preconditions.checkNotNull;
 
+/**
+ * This event is an internal event. We do not recommend handling or throwing
+ * this event or its subclasses as the interface is highly subject to change.
+ *
+ * <p>Posted when a player has to be processed, either because a world has been
+ * loaded, the server has started, or WorldGuard has been reloaded.</p>
+ */
 public class ProcessPlayerEvent extends Event {
 
     private static final HandlerList handlers = new HandlerList();