--- a/graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/InstalledCode.java	Fri Sep 07 14:11:27 2012 +0200
+++ b/graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/InstalledCode.java	Fri Sep 07 15:05:12 2012 +0200
@@ -29,6 +29,9 @@
  */
 public interface InstalledCode {
 
+    /**
+     * Exception thrown by the runtime in case an invalidated machine code is called.
+     */
     public abstract class MethodInvalidatedException extends RuntimeException {
 
         private static final long serialVersionUID = -3540232440794244844L;
@@ -45,7 +48,19 @@
      */
     boolean isValid();
 
+    /**
+     * Executes the installed code with three object arguments.
+     * @param arg1 the first argument
+     * @param arg2 the second argument
+     * @param arg3 the third argument
+     * @return the value returned by the executed code
+     */
     Object execute(Object arg1, Object arg2, Object arg3);
 
+    /**
+     * Executes the installed code with a variable number of arguments.
+     * @param args the array of object arguments
+     * @return the value returned by the executed code
+     */
     Object executeVarargs(Object... args);
 }