diff -r 151f4ccd7673 -r 60d9ea48ec99 rt/vm/src/main/java/org/apidesign/vm4brwsr/ObfuscationLevel.java
--- a/rt/vm/src/main/java/org/apidesign/vm4brwsr/ObfuscationLevel.java	Thu Mar 21 18:48:46 2013 +0100
+++ b/rt/vm/src/main/java/org/apidesign/vm4brwsr/ObfuscationLevel.java	Mon Mar 25 13:29:42 2013 +0100
@@ -23,8 +23,19 @@
  * @since 0.5
  */
 public enum ObfuscationLevel {
+    /** Generated JavaScript is (sort of) human readable. Useful for debugging.
+     * Dynamic capabilities of the virtual machine work on all classes.
+     */
     NONE,
+    /** White spaces are removed. Names of external symbols remain unchanged.
+     * Dynamic capabilities of the virtual machine work on all classes.
+     */
     MINIMAL,
-    MEDIUM,
+// temporarily commented out before merge. not well defined yet:
+//    MEDIUM,
+    /** Aggressive obfuscation of everything. Compact, unreadable "one-liner".
+     * One cannot load classes dynamically. Useful mostly for static compilation
+     * of self contained application.
+     */
     FULL
 }