Index: CHANGELOG.rst
===================================================================
--- CHANGELOG.rst	(revision 40)
+++ CHANGELOG.rst	(revision 40)
@@ -0,0 +1,1 @@
+CHANGES.rst
Index: CHANGES.rst
===================================================================
--- CHANGES.rst	(revision 40)
+++ CHANGES.rst	(revision 40)
@@ -0,0 +1,45 @@
+pyenvjasmine - changes and releases
+===================================
+
+.. contents::
+
+
+Release summary
+---------------
+
+0.3.0, April 02, 2018
+       Added selectable test engines (phantomjs and rhino supported by default)
+       with different jasmine versions
+
+
+
+Release 0.3.0
+-------------
+
+Released on April 02, 2018.
+
+Since this release, you can choose the engine that will run the tests
+(previously only rhino was available). The old rhino headless browser is still
+available (updated to the latest version) and runs tests on the latest version
+of the 1.x branch of jasmine.
+
+Also available in this version is phantomjs (you need to install phantomjs
+>= 2.1 to use this) which runs tests on the latest version of the 3.x branch of
+jasmine.
+
+**Updating from previous versions:** Up to this release *rhino* was the default
+browser/engine, now the default is *phantomjs* (which uses the most recent and
+supported *jasmine* version). If you still want to use *rhino* (and *jasmine
+1.x*), ensure you add the *testing_environment* parameter when creating a new
+*Runner* instance.
+
+For example, for this code::
+
+  runner = Runner(testdir='/path/to/my/testdir',
+                  configfile='relative/path/to/configfile')
+
+To keep running tests on *rhino*::
+
+  runner = Runner(testdir='/path/to/my/testdir',
+                  configfile='relative/path/to/configfile',
+                  testing_environment='rhino')
Index: README.rst
===================================================================
--- README.rst	(revision 26)
+++ README.rst	(revision 40)
@@ -31,4 +31,16 @@
    https://packaging.python.org/en/latest/distributing.html#working-in-development-mode
 
+.. warning::
+
+   Starting with version **0.3.0**, pyenvjasmine has support to run tests with
+   different browsers/engines. The headless browser rhino is included with
+   pyenvjasmine, but in order to use the other engines, you have to install the
+   needed browser(s).
+
+   Right now, only phantomjs_ is supported, so ensure you have it installed if
+   you want to use that browser/engine to run tests on. **Required if you want
+   to run tests on jasmine 3.x** (also required to run pyenvjasmine's own
+   tests).
+
 
 Running pyenvjasmine tests
@@ -36,5 +48,5 @@
 
 To run the tests on this code here (as opposed to *your* JavaScript code you
-want to test), install pyenvjasmine and then run::
+want to test), install pyenvjasmine (and phantomjs) and then run::
 
   py.test
@@ -58,15 +70,25 @@
             runner = Runner(
                 testdir='/path/to/my/testdir',
-                configfile='relative/path/to/configfile')
+                configfile='relative/path/to/configfile',
+                testing_environment='phantomjs')
             success, stdout = runner.run()
             # assert on success, will be true if tests passed, False if any
             # test failed
-            assert success
+            assert success, "One or more javascript tests have failed"
             # you can inspect stdout if you want to get more info, but it
             # will be printed to the console stdout anyway
             assert b'Total: 120' in stdout
 
+In this example, the *phantomjs* browse/engine is used, replace that with
+*rhino* to run tests on rhino + jasmine 1.x.
+
+.. note::
+
+   *phantomjs* is the preferred browser/engine, so it is what pyenvjasmine
+   will use as a default if you don't set *testing_environment* when creating
+   a new *Runner* instance.
 
 .. _envjasmine : https://github.com/trevmex/EnvJasmine
 .. _pip: http://www.pip-installer.org/en/latest/index.html
 .. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall
+.. _phantomjs: http://phantomjs.org
Index: setup.py
===================================================================
--- setup.py	(revision 37)
+++ setup.py	(revision 40)
@@ -2,5 +2,5 @@
 from distutils.core import setup
 
-version = '0.2.1'
+version = '0.3.0'
 
 requires = [