--- a/graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/Architecture.java	Mon May 13 22:57:50 2013 +0200
+++ b/graal/com.oracle.graal.api.code/src/com/oracle/graal/api/code/Architecture.java	Tue May 14 09:15:32 2013 +0200
@@ -198,7 +198,19 @@
         }
     }
 
+    /**
+     * Determine whether a kind can be stored in a register of a given category.
+     * 
+     * @param category the category of the register
+     * @param kind the kind that should be stored in the register
+     */
     public abstract boolean canStoreValue(RegisterCategory category, PlatformKind kind);
 
+    /**
+     * Return the largest kind that can be stored in a register of a given category.
+     * 
+     * @param category the category of the register
+     * @return the largest kind that can be stored in a register {@code category}
+     */
     public abstract PlatformKind getLargestStorableKind(RegisterCategory category);
 }