1 files changed, 23 insertions, 1 deletions
diff --git a/dice-lang/src/bjc/dicelang/dice/DieList.java b/dice-lang/src/bjc/dicelang/dice/DieList.java
index a55f2b9..5454759 100644
--- a/dice-lang/src/bjc/dicelang/dice/DieList.java
+++ b/dice-lang/src/bjc/dicelang/dice/DieList.java
@@ -1,8 +1,30 @@
 package bjc.dicelang.dice;
 
+/**
+ * Represents a group of dice.
+ *
+ * @author Ben Culkin.
+ */
 public interface DieList {
+	/**
+	 * Can this list be optimized?
+	 *
+	 * @return Whether or not this list cna be optimized.
+	 */
 	boolean canOptimize();
+	/**
+	 * Optimize this list, if it can be done.
+	 *
+	 * Invoking this on unoptimizable expression is undefined.
+	 *
+	 * @return The optimized form of this list.
+	 */
 	long[]  optimize();
 
+	/**
+	 * Roll this group of dice.
+	 *
+	 * @param A possible roll of this group.
+	 */
 	long[] roll();
-}
-\ No newline at end of file
+}