# HG changeset patch
# User Thomas Wuerthinger <thomas.wuerthinger@oracle.com>
# Date 1347023112 -7200
# Node ID 4241af3ec314551bedb2cdfbdeaf8912c098bc28
# Parent  ba78a19a7b409e48755a9e0e100923c952915209
More comments on InstalledCode.

diff -r ba78a19a7b40 -r 4241af3ec314 graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/InstalledCode.java
--- 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);
 }