diff --git a/akka-actor/src/main/scala/util/JavaAPI.scala b/akka-actor/src/main/scala/util/JavaAPI.scala
index 0943ae8bcb..1d39a0864b 100644
--- a/akka-actor/src/main/scala/util/JavaAPI.scala
+++ b/akka-actor/src/main/scala/util/JavaAPI.scala
@@ -1,9 +1,16 @@
 package se.scalablesolutions.akka.util
 
+/** A Function interface
+ * Used to create first-class-functions is Java (sort of)
+ * Java API
+ */
 trait Function[T,R] {
   def apply(param: T): R
 }
 
+/** A Procedure is like a Function, but it doesn't produce a return value
+ * Java API
+ */
 trait Procedure[T] {
   def apply(param: T): Unit
 }
\ No newline at end of file