# HG changeset patch
# User Jaroslav Tulach <jaroslav.tulach@apidesign.org>
# Date 1364214582 -3600
# Node ID 60d9ea48ec9938f1bc33084ce051de50072eddf5
# Parent  6a3a063b6eb16e06fc6c8dceb188364f9b543eca
Adding javadoc to various obfuscation levels. Disabling MEDIUM for the upcoming merge to default, as it is not finished yet.

diff -r 6a3a063b6eb1 -r 60d9ea48ec99 rt/vm/src/main/java/org/apidesign/vm4brwsr/ClosureWrapper.java
--- a/rt/vm/src/main/java/org/apidesign/vm4brwsr/ClosureWrapper.java	Mon Mar 25 13:28:33 2013 +0100
+++ b/rt/vm/src/main/java/org/apidesign/vm4brwsr/ClosureWrapper.java	Mon Mar 25 13:29:42 2013 +0100
@@ -160,10 +160,12 @@
                 return new ClosureWrapper(w, "SIMPLE_OPTIMIZATIONS",
                                           new SimpleObfuscationDelegate(),
                                           resources, arr);
+/*                
             case MEDIUM:
                 return new ClosureWrapper(w, "ADVANCED_OPTIMIZATIONS",
                                           new MediumObfuscationDelegate(),
                                           resources, arr);
+*/
             case FULL:
                 return new ClosureWrapper(w, "ADVANCED_OPTIMIZATIONS",
                                           new FullObfuscationDelegate(),
diff -r 6a3a063b6eb1 -r 60d9ea48ec99 rt/vm/src/main/java/org/apidesign/vm4brwsr/ObfuscationLevel.java
--- a/rt/vm/src/main/java/org/apidesign/vm4brwsr/ObfuscationLevel.java	Mon Mar 25 13:28:33 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
 }