1 files changed, 18 insertions, 0 deletions
diff --git a/java/src/Ice/ThreadNotification.java b/java/src/Ice/ThreadNotification.java
index 3c6868e93cc..41b687f8f14 100644
--- a/java/src/Ice/ThreadNotification.java
+++ b/java/src/Ice/ThreadNotification.java
@@ -9,8 +9,26 @@
 
 package Ice;
 
+/**
+ * Interface for thread notification hooks. Applications can derive
+ * a class tat implements the <code>start</code> and <code>stop</code>
+ * methods to intercept creation and destruction of threads created
+ * by the Ice run time.
+ *
+ * @see InitializationData
+ **/
 public interface ThreadNotification
 {
+    /**
+     * The Ice run time calls <code>start</code> for each new
+     * thread it creates. The call is made by newly-started thread.
+     **/
     void start();
+
+    /**
+     * The Ice run time calls <code>stop</code> before it destroys
+     * a thread. The call is made by thread that is about to be
+     * destroyed.
+     **/
     void stop();
 }