opal 0.9.0.beta2 → 0.9.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a71d75efaebcd98ae54fc1221323252c84d83725
-  data.tar.gz: 81f52eea1fb84c5bb009ccd90bdf4cbc2f8344a8
+  metadata.gz: 62af1a23be47ed15ba180aab47ae2b960feb1a1d
+  data.tar.gz: 228f0b9d53bb0029c97560efb41b58417e3a1312
 SHA512:
-  metadata.gz: c9fa8aa94a8350f9ec2bde008a844c4fb09d5b05917abc21045791b584adef85951106190840e50b29e047ad0f464e0acfbee5e8ac5ba2872ffac59574efc136
-  data.tar.gz: 3744c8d573fa179442543ad09d876ee64d56b2d0114c151cc2789821741c52206edce4c0ba798658d91ee3c25679aa37b37c3eb5548e6d1611a3a68b42409f5c
+  metadata.gz: f2d35d332054d7da0a7c10c617d2c71b3d0f17b9f179d352d027dca887a38725fbca63b09cd963660bd82a358fc79d9fe841b353209981db8400a63e5df843cb
+  data.tar.gz: ddb2ce713af79c8414966769b9cce482ee3d3e2cb9b16177ac9f14f4df7600e4a7a5265e8cf0ea4a713be37557d9038f576a0fdc5fec6698931e3b27b84c9289

data/.jshintrc

@@ -15,7 +15,8 @@
     "OpalNode": true,
     "callPhantom": true,
     "JSON": true,
-    "Pippo": true
+    "Pippo": true,
+    "Java": true
   },
 
   "browser": true,

data/.travis.yml

@@ -18,22 +18,25 @@ matrix:
       env: RUN=jshint SUITE=stdlib
 
     - rvm: 2.2
-      env: RUN=mspec_opal_node
+      env: RUN=mspec_opal_nodejs
 
     - rvm: 2.2
-      env: RUN=mspec_rubyspec_node TZ="/usr/share/zoneinfo/Pacific/Fiji"
+      env: RUN=mspec_rubyspec_nodejs TZ="/usr/share/zoneinfo/Pacific/Fiji"
 
     - rvm: 2.2.3
-      env: RUN=mspec_rubyspec_phantom
+      env: RUN=mspec_rubyspec_sprockets_phantomjs
 
     - rvm: 2.2
       env: RUN=rspec TILT_VERSION=2.0.1
 
+    - rvm: ruby-head
+      env: RUN=rspec
+
     - rvm: 2.1
       env: RUN=rspec
 
     - rvm: 2.0
-      env: RUN="rspec"
+      env: RUN=rspec
 
     - rvm: 1.9.3
       env: RUN=rspec
@@ -54,6 +57,7 @@ matrix:
     - rvm: 1.9.3
     - rvm: 2.1
     - rvm: 2.0
+    - rvm: ruby-head
     - rvm: rbx
     - rvm: jruby
     - rvm: jruby-head

data/CHANGELOG.md

@@ -1,47 +1,57 @@
 ## 0.9.0 (edge)
 
-*   A `console` wrapper has been added to the stdlib, requiring it will make available the `$console` global variable.
+* Fixed usage of JS keywords as instance variable names for:
+    * `Kernel#instance_variable_set`
+    * `Kernel#instance_variable_get`
+    * `Kernel#instance_variables`
 
-*   `Kernel#pp` no longer forwards arguments directly to `console.log`, this behavior has been *   `replaced by stdlib's own `console.rb` (see above).
+* Renamed:
+    * `Hash.keys` => `Hash.$$keys`
+    * `Hash.map` => `Hash.$$map`
+    * `Hash.smap` => `Hash.$$smap`
 
-*   `method_added`, `method_removed` and `method_undefined` reflection now works.
+* A `console` wrapper has been added to the stdlib, requiring it will make available the `$console` global variable.
 
-*   `singleton_method_added`, `singleton_method_removed` and `singleton_method_undefined` reflection now works.
+* `Kernel#pp` no longer forwards arguments directly to `console.log`, this behavior has been replaced by stdlib's own `console.rb` (see above).
 
-*   Now you can bridge a native class to a Ruby class that inherits from another Ruby class
+* `method_added`, `method_removed` and `method_undefined` reflection now works.
 
-*   `Numeric` semantics are now compliant with Ruby.
+* `singleton_method_added`, `singleton_method_removed` and `singleton_method_undefined` reflection now works.
 
-*   `Complex` has been fully implemented.
+* Now you can bridge a native class to a Ruby class that inherits from another Ruby class
 
-*   `Rational` has been fully implemented.
+* `Numeric` semantics are now compliant with Ruby.
 
-*   `Opal::Sprockets.javascript_include_tag` has been add to allow easy debug mode (i.e. with source maps) when including a sprockets asset into an HTML page.
+* `Complex` has been fully implemented.
 
-*   `Opal::Processor.load_asset_code(sprockets, name)` has been deprecated in favor of `Opal::Sprockets.load_asset(name, sprockets)`.
+* `Rational` has been fully implemented.
 
-*   `Struct#hash` now works properly based on struct contents
+* `Opal::Sprockets.javascript_include_tag` has been add to allow easy debug mode (i.e. with source maps) when including a sprockets asset into an HTML page.
 
-*   No longer crashes when calling a method with an opt arg followed by an optional kwarg when called without the kwarg
+* `Opal::Processor.load_asset_code(sprockets, name)` has been deprecated in favor of `Opal::Sprockets.load_asset(name, sprockets)`.
 
-*   Newly compliant with RubySpec:
-    *   `Enumerable#chunk`
-    *   `Enumerable#each_cons`
-    *   `Enumerable#minmax`
+* `Struct#hash` now works properly based on struct contents
 
-*   Operator methods (e.g. `+`, `<`, etc.) can be handled by `method_missing`
+* No longer crashes when calling a method with an opt arg followed by an optional kwarg when called without the kwarg
 
-*   `OpenStruct` - fixed `#method missing`, `#inspect`, `#to_s`, `#delete_field`. Fully compliant except for frozen and marshal behavior.
+* Newly compliant with RubySpec:
+    * `Enumerable#chunk`
+    * `Enumerable#each_cons`
+    * `Enumerable#minmax`
 
-*   Fix issue where passing a block after a parameter and a hash was causing block to not be passed (e.g. `method1 some_param, 'a' => 1, &block`)
+* Operator methods (e.g. `+`, `<`, etc.) can be handled by `method_missing`
 
-*   `Kernel#raise` now properly re-raises exceptions (regardless of how many levels deep you are) and works properly if supplied a class that has an exception method.
+* `OpenStruct` - fixed `#method missing`, `#inspect`, `#to_s`, `#delete_field`. Fully compliant except for frozen and marshal behavior.
 
-*   `Exception#exception`, `Exception::exception`, `Exception#message`, and `Exception#to_s` are fully implemented
+* Fix issue where passing a block after a parameter and a hash was causing block to not be passed (e.g. `method1 some_param, 'a' => 1, &block`)
 
-*   Method defs issued inside `Module#instance_eval` and `Class#instance_eval`, and the respective `exec` now create class methods
+* `Kernel#raise` now properly re-raises exceptions (regardless of how many levels deep you are) and works properly if supplied a class that has an exception method.
 
-*   You can make direct JavaScript method calls on using the `recv.JS.method`syntax. Has support for method calls, final callback (as a block), property getter and setter (via `#[]` and `#[]=`), splats, JavaScript keywords (via the `::JS` module) and global functions (after `require "js"`).
+* `Exception#exception`, `Exception::exception`, `Exception#message`, and `Exception#to_s` are fully implemented
+
+* Method defs issued inside `Module#instance_eval` and `Class#instance_eval`, and the respective `exec` now create class methods
+
+* You can make direct JavaScript method calls on using the `recv.JS.method`syntax. Has support for method calls, final callback (as a block), property getter and setter (via `#[]` and `#[]=`), splats, JavaScript keywords (via the `::JS` module) and global functions (after `require "js"`).
 
 * `Set#superset?`, `Set#subset?`, and the respective 'proper_' variant of each are now implemented
 
@@ -57,253 +67,262 @@
 
 * `Regexp#options` has been optimized and correctly returns 0 when called on a Regexp literal without any options (e.g. //)
 
+* Fix `Kernel#exit` to allow exit inside `#at_exit`
+
+* `BasicObject#instance_eval` now compliant with a string argument (needs `require "opal-parser"`)
+
+* Fixed `Native()` when used with `Array` instances containing native objects (which weren't wrapped properly) – #1212
+
+* Adds Nashorn (Java 8+ Javascript engine) runner `bundle exec bin/opal -R nashorn -r nashorn hello.rb`
+
+* Fixed a number of syntax errors (e.g. #1224 #1225 #1227 #1231 #1233 #1226)
 
 ## 0.8.1 2015-10-12
 
-*   Use official Sprockets processor cache keys API:
+* Use official Sprockets processor cache keys API:
     The old cache key hack has been removed.
     Add `Opal::Processor.cache_key` and `Opal::Processor.reset_cache_key!` to
     reset it as it’s cached but should change whenever `Opal::Config` changes.
 
-*   Fix an issue for which a Pathname was passed instead of a String to Sprockets.
+* Fix an issue for which a Pathname was passed instead of a String to Sprockets.
 
 ## 0.8.0 2015-07-16
 
-*   Update to Sprockets v3.0.
+* Update to Sprockets v3.0.
 
-*   Delegate dependency management directly to Sprockets (when used) making sourcemaps swift again.
+* Delegate dependency management directly to Sprockets (when used) making sourcemaps swift again.
     This means code generated by sprockets will always need to be bootstrapped via `Opal.load` or `Opal.require`.
     Luckily `Opal::Processor.load_asset_code(sprockets, name)` does just that in the right way.
 
-*   Enable operator inlining by default in the compiler.
+* Enable operator inlining by default in the compiler.
 
-*   Fix `Promise#always`.
+* Fix `Promise#always`.
 
-*   Update to Sprockets v3.0.
+* Update to Sprockets v3.0.
 
-*   Delegate dependency management directly to Sprockets (when used) making sourcemaps swift again.
+* Delegate dependency management directly to Sprockets (when used) making sourcemaps swift again.
     This means code generated by sprockets will always need to be bootstrapped via `Opal.load` or `Opal.require`.
     Luckily `Opal::Processor.load_asset_code(sprockets, name)` does just that in the right way.
 
-*   Enable operator inlining by default in the compiler.
+* Enable operator inlining by default in the compiler.
 
-*   Fix `Promise#always`.
+* Fix `Promise#always`.
 
-*   Fix `String#split` when no match is found and a limit is provided
+* Fix `String#split` when no match is found and a limit is provided
 
-*   Fix `require_tree(".")` when used from file at the root of the assets paths
+* Fix `require_tree(".")` when used from file at the root of the assets paths
 
-*   `Hash[]` implementation fully compliant with rubyspec
+* `Hash[]` implementation fully compliant with rubyspec
 
-*   Removed `minitest` from stdlib. It's not part of MRI and it never belonged there, checkout the `opal-minitest` gem instead.
+* Removed `minitest` from stdlib. It's not part of MRI and it never belonged there, checkout the `opal-minitest` gem instead.
 
-*   Parser: Allow trailing comma in paren arglists, after normal args as
+* Parser: Allow trailing comma in paren arglists, after normal args as
     well as assoc args.
 
-*   Parser: Fix parsing of parens following divide operator without a
+* Parser: Fix parsing of parens following divide operator without a
     space.
 
-*   Parser: Fix bug where keyword arguments could not be parsed if
+* Parser: Fix bug where keyword arguments could not be parsed if
     method definition did not have parens around arguments.
 
-*   Newly compliant with RubySpec:
-    *   `Array#bsearch`
-    *   `Array#combination`
-    *   `Array#permutation`
-    *   `Array#product`
-    *   `Array#rotate!`
-    *   `Array#rotate`
-    *   `Array#sample`
-    *   `Array#to_h`
-    *   `Array#values_at`
-    *   `Array#zip`
-    *   `Enumerator#with_index`
-    *   `Kernel#===`
-    *   `Kernel#Array`
-    *   `Kernel#Float`
-    *   `Kernel#Hash`
-    *   `Kernel#Integer`
-    *   `Kernel#String`
-    *   `Kernel#format`
-    *   `Kernel#sprintf`
-    *   `MatchData#==`
-    *   `MatchData#eql?`
-    *   `MatchData#values_at`
-    *   `Module#instance_methods`
-    *   `Regexp#match`
-    *   `String#%`
-    *   `String#===`
-    *   `String#==`
-    *   `String#[]`
-    *   `String#each_line`
-    *   `String#eql?`
-    *   `String#index`
-    *   `String#inspect`
-    *   `String#lines`
-    *   `String#match`
-    *   `String#next`
-    *   `String#oct`
-    *   `String#scan`
-    *   `String#slice`
-    *   `String#split`
-    *   `String#succ`
-    *   `String#to_i`
-    *   `String#try_convert`
-
-*   Misc corelib fixes:
-    *   `Module#const_get` accepts a scoped constant name
-    *   `Regexp#===` sets global match data vars
+* Newly compliant with RubySpec:
+    * `Array#bsearch`
+    * `Array#combination`
+    * `Array#permutation`
+    * `Array#product`
+    * `Array#rotate!`
+    * `Array#rotate`
+    * `Array#sample`
+    * `Array#to_h`
+    * `Array#values_at`
+    * `Array#zip`
+    * `Enumerator#with_index`
+    * `Kernel#===`
+    * `Kernel#Array`
+    * `Kernel#Float`
+    * `Kernel#Hash`
+    * `Kernel#Integer`
+    * `Kernel#String`
+    * `Kernel#format`
+    * `Kernel#sprintf`
+    * `MatchData#==`
+    * `MatchData#eql?`
+    * `MatchData#values_at`
+    * `Module#instance_methods`
+    * `Regexp#match`
+    * `String#%`
+    * `String#===`
+    * `String#==`
+    * `String#[]`
+    * `String#each_line`
+    * `String#eql?`
+    * `String#index`
+    * `String#inspect`
+    * `String#lines`
+    * `String#match`
+    * `String#next`
+    * `String#oct`
+    * `String#scan`
+    * `String#slice`
+    * `String#split`
+    * `String#succ`
+    * `String#to_i`
+    * `String#try_convert`
+
+* Misc corelib fixes:
+    * `Module#const_get` accepts a scoped constant name
+    * `Regexp#===` sets global match data vars
 
 ## 0.7.2 2015-04-23
 
-*   Remove Sprockets 3.0 support (focus moved to upcoming 0.8)
+* Remove Sprockets 3.0 support (focus moved to upcoming 0.8)
 
-*   Fix version number consistency.
+* Fix version number consistency.
 
 ## 0.7.1 2015-02-14
 
-*   CLI options `-d` and `-v` now set respectively `$DEBUG` and `$VERBOSE`
+* CLI options `-d` and `-v` now set respectively `$DEBUG` and `$VERBOSE`
 
-*   Fixed a bug that would make the `-v` CLI option wait for STDIN input
+* Fixed a bug that would make the `-v` CLI option wait for STDIN input
 
-*   Add the `-E` / `--no-exit` CLI option to skip implicit `Kernel#exit` call
+* Add the `-E` / `--no-exit` CLI option to skip implicit `Kernel#exit` call
 
-*   Now the CLI implicitly calls `Kernel#exit` at the end of the script, thus making `at_exit` blocks be respected.
+* Now the CLI implicitly calls `Kernel#exit` at the end of the script, thus making `at_exit` blocks be respected.
 
 ## 0.7.0 2015-02-01
 
-*   Stop keyword-arg variable names leaking to global javascript scope
+* Stop keyword-arg variable names leaking to global javascript scope
 
-*   `Class#native_class` now also exposes `MyClass.new` (Ruby) as `Opal.global.MyClass.new()` (JS)
+* `Class#native_class` now also exposes `MyClass.new` (Ruby) as `Opal.global.MyClass.new()` (JS)
 
-*   Add CRuby (MRI) tests harness to start checking Opal against them too.
+* Add CRuby (MRI) tests harness to start checking Opal against them too.
 
-*   Add Minitest to the stdlib.
+* Add Minitest to the stdlib.
 
-*   Add `Date#<=>` with specs.
+* Add `Date#<=>` with specs.
 
-*   Show extended info and context upon parsing, compiling and building errors.
+* Show extended info and context upon parsing, compiling and building errors.
 
-*   Support keyword arguments in method calls and definitions.
+* Support keyword arguments in method calls and definitions.
 
-*   Fix `begin`/`rescue` blocks to evaluate to last expression.
+* Fix `begin`/`rescue` blocks to evaluate to last expression.
 
-*   Add support for `RUBY_ENGINE/RUBY_PLATFORM != "opal"` pre-processor directives.
+* Add support for `RUBY_ENGINE/RUBY_PLATFORM != "opal"` pre-processor directives.
 
         if RUBY_ENGINE != "opal"
           # this code never compiles
         end
 
-*   Fix donating methods defined in modules. This ensures that if a class includes more than one module, then the methods defined on the class respect the order in which the modules are included.
+* Fix donating methods defined in modules. This ensures that if a class includes more than one module, then the methods defined on the class respect the order in which the modules are included.
 
-*   Improved support for recursive `Hash` for both `#inspect` and `#hash`.
+* Improved support for recursive `Hash` for both `#inspect` and `#hash`.
 
-*   Optimized `Hash` implementation for `String` and `Symbol`, they have a separate hash-table in which they're used as both keys and hashes.
+* Optimized `Hash` implementation for `String` and `Symbol`, they have a separate hash-table in which they're used as both keys and hashes.
 
-*   Added real `#hash` / `eql?` support, previously was relying on `.toString()`.
+* Added real `#hash` / `eql?` support, previously was relying on `.toString()`.
 
-*   `String#to_proc` now uses `__send__` instead of `send` for calling
+* `String#to_proc` now uses `__send__` instead of `send` for calling
     methods on receivers.
 
-*   Deprecated `Opal::Sprockets::Environment`. It can easily be replaced by `Opal::Server` or by appending `Opal.paths` to a `Sprockets::Environment`:
+* Deprecated `Opal::Sprockets::Environment`. It can easily be replaced by `Opal::Server` or by appending `Opal.paths` to a `Sprockets::Environment`:
 
         Sprockets::Environment.new.tap { |e| Opal.paths.each {|p| e.append_path(p)} }
 
-*   Add `Set` methods `#classify`, `#collect!`, `#map!`, `#subtract` `#replace`,
+* Add `Set` methods `#classify`, `#collect!`, `#map!`, `#subtract` `#replace`,
     `#difference` and `#eql?`
 
-*   Support `module_function` without args to toggle module functions.
+* Support `module_function` without args to toggle module functions.
 
-*   Fix bug where command calls with no space and sym arg were incorrectly parsed.
+* Fix bug where command calls with no space and sym arg were incorrectly parsed.
 
-*   Add some `StringScanner` methods.
+* Add some `StringScanner` methods.
 
-*   Add `Date#<<` and `Date#>>` implementations.
+* Add `Date#<<` and `Date#>>` implementations.
 
-*   Support nested directories using `require_tree` directive.
+* Support nested directories using `require_tree` directive.
 
-*   Fix bug where Exception subclasses could not have methods defined on them.
+* Fix bug where Exception subclasses could not have methods defined on them.
 
-*   Fix symbols with interpolations `:"#{foo}"`
+* Fix symbols with interpolations `:"#{foo}"`
 
-*   Implement $1..N matchers and rewrite support for $~, $', $& and $\`.
+* Implement $1..N matchers and rewrite support for $~, $', $& and $\`.
 
-*   Implement `Regexp.last_match`.
+* Implement `Regexp.last_match`.
 
-*   Fixed `-@` unary op. precedence with a numeric and followed by a method call (e.g. `-1.foo` was parsed as `-(1.foo)`)
+* Fixed `-@` unary op. precedence with a numeric and followed by a method call (e.g. `-1.foo` was parsed as `-(1.foo)`)
 
-*   `require_relative` (with strings) is now preprocessed, expanded and added to `Compiler#requires`
+* `require_relative` (with strings) is now preprocessed, expanded and added to `Compiler#requires`
 
-*   Rewritten the require system to respect requires position (previously all the requires were stacked up at the top of the file)
+* Rewritten the require system to respect requires position (previously all the requires were stacked up at the top of the file)
 
-*   Implement for-loop syntax
+* Implement for-loop syntax
 
-*   Add Array#|
+* Add Array#|
 
-*   Fix Range.new to raise `ArgumentError` on contructor values that cannot
+* Fix Range.new to raise `ArgumentError` on contructor values that cannot
     be compared
 
-*   Fix compiler bug where Contiguous strings were not getting concatenated.
+* Fix compiler bug where Contiguous strings were not getting concatenated.
 
-*   Cleanup generated code for constant access. All constant lookups now go through `$scope.get('CONST_NAME')` to produce cleaner code and a unified place for const missing dispatch.
+* Cleanup generated code for constant access. All constant lookups now go through `$scope.get('CONST_NAME')` to produce cleaner code and a unified place for const missing dispatch.
 
-*   Remove `const_missing` option from compiler. All constant lookups are now strict.
+* Remove `const_missing` option from compiler. All constant lookups are now strict.
 
-*   Add initial support for Module#autoload.
+* Add initial support for Module#autoload.
 
-*   Fix `Enumerator#with_index`, `Numeric#round`.
+* Fix `Enumerator#with_index`, `Numeric#round`.
 
 ## 0.6.2 2014-04-25
 
-*   Added Range#size
+* Added Range#size
 
-*   `opal` executable now reads STDIN when no file or `-e` are passed
+* `opal` executable now reads STDIN when no file or `-e` are passed
 
-*   `opal` executable doesn't exit after showing version on `-v` if other options are passed
+* `opal` executable doesn't exit after showing version on `-v` if other options are passed
 
-*   (Internal) improved the mspec runner
+* (Internal) improved the mspec runner
 
 ## 0.6.1 2014-04-15
 
-*   Updated RubySpecs to master and added `rubysl-*` specs. Thanks to Mike Owens (@mieko)
+* Updated RubySpecs to master and added `rubysl-*` specs. Thanks to Mike Owens (@mieko)
 
-*   Added `Kernel#require_remote(url)` in `opal-parser` that requires files with basic synchronous ajax
+* Added `Kernel#require_remote(url)` in `opal-parser` that requires files with basic synchronous ajax
     GET requests. It is used to load `<scripts type="text/ruby" src="…url…">`.
 
-*   Various parsing fixes (Hash parsing, `def` returns method name, cleanup `core/util`, Enumerator fixes)
+* Various parsing fixes (Hash parsing, `def` returns method name, cleanup `core/util`, Enumerator fixes)
 
-*   Added `#native_reader`, `#native_writer` and `#native_accessor`as class methods
+* Added `#native_reader`, `#native_writer` and `#native_accessor`as class methods
     donated by `include Native`
 
-*   Added specs for Sprockets' processors (both .js.rb and .opalerb), backported from `opal-rails`
+* Added specs for Sprockets' processors (both .js.rb and .opalerb), backported from `opal-rails`
 
-*   Set 2.1.1 as RUBY_VERSION
+* Set 2.1.1 as RUBY_VERSION
 
-*   Add `opal-build` command utility to easily build libraries to js
+* Add `opal-build` command utility to easily build libraries to js
 
-*   Add `opal-repl` to gemspec executables,
+* Add `opal-repl` to gemspec executables,
     previously was only available by using Opal from source
 
-*   Fix parsing `=>` in hash literals where it would sometimes incorrectly
+* Fix parsing `=>` in hash literals where it would sometimes incorrectly
     parse as a key name.
 
 ## 0.6.0 2014-03-05
 
-*   Fix parsing of escapes in single-strings ('foo\n'). Only ' and \
+* Fix parsing of escapes in single-strings ('foo\n'). Only ' and \
     characters now get escaped in single quoted strings. Also, more escape
     sequences in double-quoted strings are now supported: `\a`, `\v`, `\f`,
     `\e`, `\s`, octal (`\314`), hex (`\xff`) and unicode (`\u1234`).
 
-*   Sourcemaps revamp. Lexer now tracks column and line info for every token to
+* Sourcemaps revamp. Lexer now tracks column and line info for every token to
     produce much more accurate sourcemaps. All method calls are now located on
     the correct source line, and multi-line xstrings are now split to generate
     a map line-to-line for long inline javascript parts.
 
-*   Merged sprockets support from `opal-sprockets` directly into Opal. For the
+* Merged sprockets support from `opal-sprockets` directly into Opal. For the
     next release, the exernal `opal-sprockets` gem is no longer needed. This
     commit adds `Opal::Processor`, `Opal::Server` and `Opal::Environment`.
 
-*   Introduce pre-processed if directives to hide code from Opal. Two special
+* Introduce pre-processed if directives to hide code from Opal. Two special
     constant checks now take place in the compiler. Either `RUBY_ENGINE` or
     `RUBY_PLATFORM` when `== "opal"`. Both if and unless statements can pick
     up these logic checks:
@@ -323,316 +342,316 @@
     This is particularly useful for avoiding `require()` statements being
     picked up, which are included at compile time.
 
-*   Add special `debugger` method to compiler. Compiles down to javascript
+* Add special `debugger` method to compiler. Compiles down to javascript
     `debugger` keyword to start in-browser debug console.
 
-*   Add missing string escapes to `read_escape` in lexer. Now most ruby escape
+* Add missing string escapes to `read_escape` in lexer. Now most ruby escape
     sequences are properly detected and handled in string parsing.
 
-*   Disable escapes inside x-strings. This means no more double escaping all
+* Disable escapes inside x-strings. This means no more double escaping all
     characters in x-strings and backticks. (`\n` => `\n`).
 
-*   Add `time.rb` to stdlib and moved `Time.parse()` and `Time.iso8601()`
+* Add `time.rb` to stdlib and moved `Time.parse()` and `Time.iso8601()`
     methods there.
 
-*   `!` is now treated as an unary method call on the object. Opal now parsed
+* `!` is now treated as an unary method call on the object. Opal now parsed
     `!` as a def method name, and implements the method on `BasicObject`,
     `NilClass` and `Boolean`.
 
-*   Fixed bug where true/false as object literals from javascript were not
+* Fixed bug where true/false as object literals from javascript were not
     correctly being detected as truthy/falsy respectively. This is due to the
     javascript "feature" where `new Boolean(false) !== false`.
 
-*   Moved `native.rb` to stdlib. Native support must now be explicitly required
+* Moved `native.rb` to stdlib. Native support must now be explicitly required
     into Opal. `Native` is also now a module, instead of a top level class.
     Also added `Native::Object#respond_to?`.
 
-*   Remove all core `#as_json()` methods from `json.rb`. Added them externally
+* Remove all core `#as_json()` methods from `json.rb`. Added them externally
     to `opal-activesupport`.
 
-*   `Kernel#respond_to?` now calls `#respond_to_missing?` for compliance.
+* `Kernel#respond_to?` now calls `#respond_to_missing?` for compliance.
 
-*   Fix various `String` methods and add relevant rubyspecs for them. `#chars`,
+* Fix various `String` methods and add relevant rubyspecs for them. `#chars`,
     `#to_f`, `#clone`, `#split`.
 
-*   Fix `Array` method compliance: `#first`, `#fetch`, `#insert`, `#delete_at`,
+* Fix `Array` method compliance: `#first`, `#fetch`, `#insert`, `#delete_at`,
     `#last`, `#splice`, `.try_convert`.
 
-*   Fix compliance of `Kernel#extend` and ensure it calls `#extended()` hook.
+* Fix compliance of `Kernel#extend` and ensure it calls `#extended()` hook.
 
-*   Fix bug where sometimes the wrong regexp flags would be generated in the
+* Fix bug where sometimes the wrong regexp flags would be generated in the
     output javascript.
 
-*   Support parsing `__END__` constructs in ruby code, inside the lexer. The
+* Support parsing `__END__` constructs in ruby code, inside the lexer. The
     content is gathered up by use of the parser. The special constant `DATA`
     is then available inside the ruby code to read the content.
 
-*   Support single character strings (using ? prefix) with escaped characters.
+* Support single character strings (using ? prefix) with escaped characters.
 
-*   Fix lexer to detect dereferencing on local variables even when whitespace
+* Fix lexer to detect dereferencing on local variables even when whitespace
     is present (`a = 0; a [0]` parses as a deference on a).
 
-*   Fix various `Struct` methods. Fixed `#each` and `#each_pair` to return
+* Fix various `Struct` methods. Fixed `#each` and `#each_pair` to return
     self. Add `Struct.[]` as synonym for `Struct.new`.
 
-*   Implemented some `Enumerable` methods: `#collect_concat`, `#flat_map`,
+* Implemented some `Enumerable` methods: `#collect_concat`, `#flat_map`,
     `#reject`, `#reverse_each`, `#partition` and `#zip`.
 
-*   Support any Tilt template for `index_path` in `Opal::Server`. All index
+* Support any Tilt template for `index_path` in `Opal::Server`. All index
     files are now run through `Tilt` (now supports haml etc).
 
-*   Fix code generation of `op_asgn_1` calls (`foo[val] += 10`).
+* Fix code generation of `op_asgn_1` calls (`foo[val] += 10`).
 
-*   Add `base64` to stdlib.
+* Add `base64` to stdlib.
 
-*   Add promises implementation to stdlib.
+* Add promises implementation to stdlib.
 
-*   Add `Math` module to corelib.
+* Add `Math` module to corelib.
 
-*   Use `//#` instead of `//@` deprecated syntax for sourceMappingURL.
+* Use `//#` instead of `//@` deprecated syntax for sourceMappingURL.
 
-*   Implicitly require `erb` from stdlib when including erb templates.
+* Implicitly require `erb` from stdlib when including erb templates.
 
-*   Fix `Regexp.escape` to also escape '(' character.
+* Fix `Regexp.escape` to also escape '(' character.
 
-*   Support '<' and '>' as matching pairs in string boundrys `%q<hi>`.
+* Support '<' and '>' as matching pairs in string boundrys `%q<hi>`.
 
-*   `Opal::Server` no longer searches for an index file if not specified.
+* `Opal::Server` no longer searches for an index file if not specified.
 
-*   Move `Math` and `Encoding` to stdlib. Can be required using
+* Move `Math` and `Encoding` to stdlib. Can be required using
     `require 'math'`, etc.
 
-*   Fix some stdlib `Date` methods.
+* Fix some stdlib `Date` methods.
 
-*   Fix `Regexp.escape` to properly escape \n, \t, \r, \f characters.
+* Fix `Regexp.escape` to properly escape \n, \t, \r, \f characters.
 
-*   Add `Regexp.quote` as an alias of `escape`.
+* Add `Regexp.quote` as an alias of `escape`.
 
 ## 0.5.5 2013-11-25
 
-*   Fix regression: add `%i[foo bar]` style words back to lexer
+* Fix regression: add `%i[foo bar]` style words back to lexer
 
-*   Move corelib from `opal/core` to `opal/corelib`. This stops files in
+* Move corelib from `opal/core` to `opal/corelib`. This stops files in
     `core/` clashing with user files.
 
 ## 0.5.4 2013-11-20
 
-*   Reverted `RUBY_VERSION` to `1.9.3`. Opal `0.6.0` will be the first release
+* Reverted `RUBY_VERSION` to `1.9.3`. Opal `0.6.0` will be the first release
     for `2.0.0`.
 
 ## 0.5.3 2013-11-12
 
-*   Opal now targets ruby 2.0.0
+* Opal now targets ruby 2.0.0
 
-*   Named function inside class body now generates with `$` prefix, e.g.
+* Named function inside class body now generates with `$` prefix, e.g.
     `$MyClass`. This makes it easier to wrap/bridge native functions.
 
-*   Support Array subclasses
+* Support Array subclasses
 
-*   Various fixes to `String`, `Kernel` and other core classes
+* Various fixes to `String`, `Kernel` and other core classes
 
-*   Fix `Method#call` to use correct receiver
+* Fix `Method#call` to use correct receiver
 
-*   Fix `Module#define_method` to call `#to_proc` on explicit argument
+* Fix `Module#define_method` to call `#to_proc` on explicit argument
 
-*   Fix `super()` dispatches on class methods
+* Fix `super()` dispatches on class methods
 
-*   Support `yield()` calls from inside a block (inside a method)
+* Support `yield()` calls from inside a block (inside a method)
 
-*   Cleanup string parsing inside lexer
+* Cleanup string parsing inside lexer
 
-*   Cleanup parser/lexer to use `t` and `k` prefixes for all tokens
+* Cleanup parser/lexer to use `t` and `k` prefixes for all tokens
 
 ## 0.5.2 2013-11-11
 
-*   Include native into corelib for 0.5.x
+* Include native into corelib for 0.5.x
 
 ## 0.5.1 2013-11-10
 
-*   Move all corelib under `core/` directory to prevent filename clashes with
+* Move all corelib under `core/` directory to prevent filename clashes with
     `require`
 
-*   Move `native.rb` into stdlib - must now be explicitly required
+* Move `native.rb` into stdlib - must now be explicitly required
 
-*   Implement `BasicObject#__id__`
+* Implement `BasicObject#__id__`
 
-*   Cleanup and fix various `Enumerable` methods
+* Cleanup and fix various `Enumerable` methods
 
 ## 0.5.0 2013-11-03
 
-*   WIP: https://gist.github.com/elia/7747460
+* WIP: https://gist.github.com/elia/7747460
 
 ## 0.4.2 2013-07-03
 
-*   Added `Kernel#rand`. (fntzr)
+* Added `Kernel#rand`. (fntzr)
 
-*   Restored the `bin/opal` executable in gemspec.
+* Restored the `bin/opal` executable in gemspec.
 
-*   Now `.valueOf()` is used in `#to_n` of Boolean, Numeric, Regexp and String
+* Now `.valueOf()` is used in `#to_n` of Boolean, Numeric, Regexp and String
     to return the naked JavaScript value instead of a wrapping object.
 
-*   Parser now wraps or-ops in paranthesis to stop variable order from
+* Parser now wraps or-ops in paranthesis to stop variable order from
     leaking out when minified by uglify. We now have code in this
     format: `(((tmp = lhs) !== false || !==nil) ? tmp : rhs)`.
 
 ## 0.4.1 2013-06-16
 
-*   Move sprockets logic out to external opal-sprockets gem. That now
+* Move sprockets logic out to external opal-sprockets gem. That now
     handles the compiling and loading of opal files in sprockets.
 
 ## 0.4.0 2013-06-15
 
-*   Added fragments to parser. All parser methods now generate one or
+* Added fragments to parser. All parser methods now generate one or
     more Fragments which store the original sexp. This allows us to
     enumerate over them after parsing to map generated lines back to
     original line numbers.
 
-*   Reverted `null` for `nil`. Too buggy at this time.
+* Reverted `null` for `nil`. Too buggy at this time.
 
-*   Add Opal::SprocketsParser as Parser subclass for handling parsing
+* Add Opal::SprocketsParser as Parser subclass for handling parsing
     for sprockets environment. This subclass handles require statements
     and stores them for sprockets to use.
 
-*   Add :irb option to parser to keep top level lvars stored inside
+* Add :irb option to parser to keep top level lvars stored inside
     opal runtime so that an irb session can be persisted and maintain
     access to local variables.
 
-*   Add Opal::Environment#use_gem() helper to add a gem to opals load
+* Add Opal::Environment#use_gem() helper to add a gem to opals load
     path.
 
-*   Stop pre-setting ivars to `nil`. This is no longer needed as `nil`
+* Stop pre-setting ivars to `nil`. This is no longer needed as `nil`
     is now `null` or `undefined`.
 
-*   Use `null` as `nil` in opal. This allows us to send methods to
+* Use `null` as `nil` in opal. This allows us to send methods to
     `null` and `undefined`, and both act as `nil`. This makes opal a
     much better javascript citizen. **REVERTED**
 
-*   Add Enumerable#none? with specs.
+* Add Enumerable#none? with specs.
 
-*   Add Opal.block_send() runtime helper for sending methods to an
+* Add Opal.block_send() runtime helper for sending methods to an
     object which uses a block.
 
-*   Remove \_klass variable for denoting ruby classes, and use
+* Remove \_klass variable for denoting ruby classes, and use
     constructor instead. constructor is a javascript property used for
     the same purpose, and this makes opal fit in as a better js citizen.
 
-*   Add Class.bridge\_class method to bridge a native constructor into an
+* Add Class.bridge\_class method to bridge a native constructor into an
     opal class which will set it up with all methods from Object, as
     well as giving it a scope and name.
 
-*   Added native #[]= and #to_h methods, for setting properties and
+* Added native #[]= and #to_h methods, for setting properties and
     converting to a hash respectivaly.
 
-*   Fix bug where '::' was parsed as :colon2 instead of :colon3 when in
+* Fix bug where '::' was parsed as :colon2 instead of :colon3 when in
     an args scope. Fixes #213
 
-*   Remove lots of properties added to opal classes. This makes normal
+* Remove lots of properties added to opal classes. This makes normal
     js constructors a lot closer to opal classes, making is easier to
     treat js classes as opal classes.
 
-*   Merge Hash.from_native into Hash.new
+* Merge Hash.from_native into Hash.new
 
 ## 0.3.44 2013-05-31
 
-*   Cleanup runtime, and remove various flags and functions from opal
+* Cleanup runtime, and remove various flags and functions from opal
     objects and classes (moving them to runtime methods).
 
-*   Remove some activesupport methods into external lib.
+* Remove some activesupport methods into external lib.
 
-*   Add/fix lots of String methods, with specs.
+* Add/fix lots of String methods, with specs.
 
-*   Add more methods to MatchData class.
+* Add more methods to MatchData class.
 
-*   Implement $' and $` variables.
+* Implement $' and $` variables.
 
-*   Opal can now call methods on all native objects, via method missing
+* Opal can now call methods on all native objects, via method missing
     dispatcher.
 
-*   Add Opal::Environment as custom sprockets subclass which adds all
+* Add Opal::Environment as custom sprockets subclass which adds all
     opal load paths automatically.
 
 ## 0.3.43 2013-05-02
 
-*   Stop inlining respond_to? inside the parser. This now fully respects
+* Stop inlining respond_to? inside the parser. This now fully respects
     an object overriding respond_to?.
 
-*   Expose `Opal.eval()` function when parser is loaded for parsing
+* Expose `Opal.eval()` function when parser is loaded for parsing
     and running strings of ruby code.
 
-*   Add erb to corelib (as well as compiler to gem lib). ERB files with
+* Add erb to corelib (as well as compiler to gem lib). ERB files with
     .opalerb extension will automatically be compiled into Template
     constant.
 
-*   Added some examples into examples/ dir.
+* Added some examples into examples/ dir.
 
-*   Add Opal.send() javascript function for sending methods to ruby
+* Add Opal.send() javascript function for sending methods to ruby
     objects.
 
-*   Native class for wrapping and interacting with native objects and
+* Native class for wrapping and interacting with native objects and
     function calls.
 
-*   Add local_storage to stdlib as a basic wrapper around localStorage.
+* Add local_storage to stdlib as a basic wrapper around localStorage.
 
-*   Make method_missing more performant by reusing same dispatch function
+* Make method_missing more performant by reusing same dispatch function
     instead of reallocating one for each run.
 
-*   Fix Kernel#format to work in firefox. String.prototype.replace() had
+* Fix Kernel#format to work in firefox. String.prototype.replace() had
     different semantics for empty matching groups which was breaking
     Kernel#format.
 
 ## 0.3.42 2013-03-21
 
-*   Fix/add lots of language specs.
+* Fix/add lots of language specs.
 
-*   Seperate sprockets support out to opal-sprockets gem.
+* Seperate sprockets support out to opal-sprockets gem.
 
-*   Support %r[foo] style regexps.
+* Support %r[foo] style regexps.
 
-*   Use mspec to run specs on corelib and runtime. Rubyspecs are now
+* Use mspec to run specs on corelib and runtime. Rubyspecs are now
     used, where possible to be as compliant as possible.
 
 ## 0.3.41 2013-02-26
 
-*   Remove bin/opal - no longer required for building sources.
+* Remove bin/opal - no longer required for building sources.
 
-*   Depreceate Opal::Environment. The Opal::Server class provides a better
+* Depreceate Opal::Environment. The Opal::Server class provides a better
     method of using the opal load paths. Opal.paths still stores a list of
     load paths for generic sprockets based apps to use.
 
 ## 0.3.40 2013-02-23
 
-*   Add Opal::Server as an easy to configure rack server for testing and
+* Add Opal::Server as an easy to configure rack server for testing and
     running Opal based apps.
 
-*   Added optional arity check mode for parser. When turned on, every method
+* Added optional arity check mode for parser. When turned on, every method
     will have code which checks the argument arity. Off by default.
 
-*   Exception subclasses now relfect their name in webkit/firefox debuggers
+* Exception subclasses now relfect their name in webkit/firefox debuggers
     to show both their class name and message.
 
-*   Add Class#const_set. Trying to access undefined constants by a literal
+* Add Class#const_set. Trying to access undefined constants by a literal
     constant will now also raise a NameError.
 
 ## 0.3.39 2013-02-20
 
-*   Fix bug where methods defined on a parent class after subclass was defined
+* Fix bug where methods defined on a parent class after subclass was defined
     would not given subclass access to method. Subclasses are now also tracked
     by superclass, by a private '_inherited' property.
 
-*   Fix bug where classes defined by `Class.new` did not have a constant scope.
+* Fix bug where classes defined by `Class.new` did not have a constant scope.
 
-*   Move Date out of opal.rb loading, as it is part of stdlib not corelib.
+* Move Date out of opal.rb loading, as it is part of stdlib not corelib.
 
-*   Fix for defining methods inside metaclass, or singleton_class scopes.
+* Fix for defining methods inside metaclass, or singleton_class scopes.
 
 ## 0.3.38 2013-02-13
 
-*   Add Native module used for wrapping objects to forward calls as native
+* Add Native module used for wrapping objects to forward calls as native
     calls.
 
-*   Support method_missing for all objects. Feature can be enabled/disabled on
+* Support method_missing for all objects. Feature can be enabled/disabled on
     Opal::Processor.
 
-*   Hash can now use any ruby object as a key.
+* Hash can now use any ruby object as a key.
 
-*   Move to Sprockets based building via `Opal::Processor`.
+* Move to Sprockets based building via `Opal::Processor`.