update code comments

Author: guybedford

dist/es6-module-loader-sans-promises.js

@@ -3,25 +3,22 @@
 
   Loader Polyfill
 
-    - Implemented exactly to the 2013-12-02 Specification Draft -
+    - Implemented exactly to the 2014-04-27 Specification Draft.
+      Loader implemented to the modules draft from
       https://github.com/jorendorff/js-loaders/blob/e60d3651/specs/es6-modules-2013-12-02.pdf
-      with the only exceptions as described here
+    
+    - All functions are commented with their spec numbers, with spec differences commented.
+
+    - All spec bugs are commented in this code with links to the spec bugs.
 
     - Abstract functions have been combined where possible, and their associated functions
-      commented
+      commented.
 
     - When the traceur global is detected, declarative modules are transformed by Traceur
-      before execution. The Traceur parse tree is stored as load.body, analogously to the
-      spec
-
-    - Link and EnsureEvaluated have been customised from the spec
-
-    - Module Linkage records are stored as: { module: (actual module), dependencies, body, name, address }
-
-    - Cycles are not supported at all and will throw an error
+      into the `instantiate` System.register output.
 
-    - Realm implementation is entirely omitted. As such, Loader.global and Loader.realm
-      accessors will throw errors, as well as Loader.eval. Realm arguments are not passed.
+    - Realm implementation is entirely omitted. As such, the Loader.realm accessor will 
+      throw an error, as well as Loader.eval. Realm arguments are not passed.
 
     - Loader module table iteration currently not yet implemented
 

dist/es6-module-loader.js

@@ -687,25 +687,22 @@ requireModule('promise/polyfill').polyfill();
 
   Loader Polyfill
 
-    - Implemented exactly to the 2013-12-02 Specification Draft -
+    - Implemented exactly to the 2014-04-27 Specification Draft.
+      Loader implemented to the modules draft from
       https://github.com/jorendorff/js-loaders/blob/e60d3651/specs/es6-modules-2013-12-02.pdf
-      with the only exceptions as described here
+    
+    - All functions are commented with their spec numbers, with spec differences commented.
+
+    - All spec bugs are commented in this code with links to the spec bugs.
 
     - Abstract functions have been combined where possible, and their associated functions
-      commented
+      commented.
 
     - When the traceur global is detected, declarative modules are transformed by Traceur
-      before execution. The Traceur parse tree is stored as load.body, analogously to the
-      spec
-
-    - Link and EnsureEvaluated have been customised from the spec
-
-    - Module Linkage records are stored as: { module: (actual module), dependencies, body, name, address }
-
-    - Cycles are not supported at all and will throw an error
+      into the `instantiate` System.register output.
 
-    - Realm implementation is entirely omitted. As such, Loader.global and Loader.realm
-      accessors will throw errors, as well as Loader.eval. Realm arguments are not passed.
+    - Realm implementation is entirely omitted. As such, the Loader.realm accessor will 
+      throw an error, as well as Loader.eval. Realm arguments are not passed.
 
     - Loader module table iteration currently not yet implemented
 

lib/loader.js

@@ -3,25 +3,22 @@
 
   Loader Polyfill
 
-    - Implemented exactly to the 2013-12-02 Specification Draft -
+    - Implemented exactly to the 2014-04-27 Specification Draft.
+      Loader implemented to the modules draft from
       https://github.com/jorendorff/js-loaders/blob/e60d3651/specs/es6-modules-2013-12-02.pdf
-      with the only exceptions as described here
+    
+    - All functions are commented with their spec numbers, with spec differences commented.
+
+    - All spec bugs are commented in this code with links to the spec bugs.
 
     - Abstract functions have been combined where possible, and their associated functions
-      commented
+      commented.
 
     - When the traceur global is detected, declarative modules are transformed by Traceur
-      before execution. The Traceur parse tree is stored as load.body, analogously to the
-      spec
-
-    - Link and EnsureEvaluated have been customised from the spec
-
-    - Module Linkage records are stored as: { module: (actual module), dependencies, body, name, address }
-
-    - Cycles are not supported at all and will throw an error
+      into the `instantiate` System.register output.
 
-    - Realm implementation is entirely omitted. As such, Loader.global and Loader.realm
-      accessors will throw errors, as well as Loader.eval. Realm arguments are not passed.
+    - Realm implementation is entirely omitted. As such, the Loader.realm accessor will 
+      throw an error, as well as Loader.eval. Realm arguments are not passed.
 
     - Loader module table iteration currently not yet implemented