Added comments to Java & C# timer class

1 files changed, 9 insertions, 0 deletions

diff --git a/java/src/IceInternal/Timer.java b/java/src/IceInternal/Timer.java
index aef11cbf5c7..10a7e40f7a0 100644
--- a/java/src/IceInternal/Timer.java
+++ b/java/src/IceInternal/Timer.java
@@ -9,6 +9,15 @@
 
 package IceInternal;
 
+//
+// NOTE: We don't use the java.util.Timer class for few reasons. The
+// Java TimerTask is a class not an interface making it more difficult
+// to use. The API is also a bit different, cancel() is a TimerTask
+// method not a Timer method and calling purge() on the timer on a
+// regular basis is required to allow canceled timer task objects to
+// be garbage collected.
+//
+
 interface TimerTask
 {
     void runTimerTask();