refs #532 - added bitds of docs regarding SlimerJS support

@@ -87,7 +87,7 @@ Execution results:
 
 .. versionadded:: 1.1
 
-.. index:: Logging, log levels
+.. index:: Logging, log levels, SlimerJS
 
 The `casperjs` command has three available options:
 

@@ -2,7 +2,7 @@
 CasperJS documentation
 ======================
 
-CasperJS_ is a navigation scripting & testing utility for PhantomJS_, written in Javascript.
+CasperJS_ is a navigation scripting & testing utility for the PhantomJS_ (WebKit) and SlimerJS_ (Gecko) headless browsers, written in Javascript.
 
 .. figure:: _static/images/casperjs-logo.png
    :align: right
@@ -43,3 +43,4 @@ Community
 
 .. _CasperJS: http://casperjs.org/
 .. _PhantomJS: http://phantomjs.org/
+.. _SlimerJS: http://slimerjs.org/

@@ -17,25 +17,13 @@ Prerequisites
 
 .. versionadded:: 1.1
 
-- Experimental: SlimerJS_ 0.8 or greater to run your tests against Gecko (Firefox) instead of Webkit.
+- **Experimental:** as of 1.1-beta1, SlimerJS_ 0.8 or greater to run your tests against Gecko (Firefox) instead of Webkit. To see PhantomJS API compatibility of SLimerJS, please `refer to this page <https://github.com/laurentj/slimerjs/blob/master/API_COMPAT.md>`_.
 
-.. note::
-
-   .. versionadded:: 1.0
-
-   A `Ruby <http://ruby-lang.org/>`_ version of the ``casperjs`` executable is also available in the ``rubybin/`` directory; in order to use the :index:`Ruby` version instead of the Python one:
-
-   .. code-block:: text
-
-       $ ln -sf `pwd`/rubybin/casperjs /usr/local/bin/casperjs
+.. warning::
 
-   Or using the ruby interpreter:
+   .. deprecated:: 1.1
 
-   .. code-block:: text
-
-       $ ruby /path/to/casperjs/rubybin/casperjs
-       CasperJS version 1.1-DEV at /path/to/casperjs/rubybin/casperjs, using PhantomJS version 1.7.0
-       ...
+   The `Ruby <http://ruby-lang.org/>`_ version of the ``casperjs`` executable also available in the ``rubybin/`` directory has been deprecated as of 1.1-beta, and is not compatible with SLimerJS_.
 
 .. index:: Homebrew
 
@@ -53,14 +41,13 @@ Installing from git
 
 Installation can be achieved using `git <http://git-scm.com/>`_. The code is mainly hosted on `Github <https://github.com/n1k0/casperjs>`_.
 
-From a stable tag
-~~~~~~~~~~~~~~~~~
+From the master branch
+~~~~~~~~~~~~~~~~~~~~~~
 
 .. code-block:: text
 
     $ git clone git://github.com/n1k0/casperjs.git
     $ cd casperjs
-    $ git checkout tags/1.0
     $ ln -sf `pwd`/bin/casperjs /usr/local/bin/casperjs
 
 Once PhantomJS and CasperJS installed on your machine, you should obtain something like this:
@@ -69,27 +56,18 @@ Once PhantomJS and CasperJS installed on your machine, you should obtain somethi
 
     $ phantomjs --version
     1.8.2
-    $ casperjs --version
-    1.0
-
-From the master branch
-~~~~~~~~~~~~~~~~~~~~~~
-
-The ``master`` branch hosts the current development version of CasperJS.
-
-.. code-block:: text
-
-    $ git clone git://github.com/n1k0/casperjs.git
-    $ cd casperjs
-    $ git checkout master
-    $ ln -sf `pwd`/bin/casperjs /usr/local/bin/casperjs
+    $ casperjs
+    CasperJS version 1.1.0-DEV at /Users/niko/Sites/casperjs, using phantomjs version 1.9.0
+    # ...
 
-To check your current installed version:
+Or if SlimerJS is your thing:
 
 .. code-block:: text
 
-    $ casperjs --version
-    1.1-DEV
+    $ slimerjs --version
+    Innophi SlimerJS 0.8pre, Copyright 2012-2013 Laurent Jouanneau & Innophi
+    $ casperjs
+    CasperJS version 1.1.0-DEV at /Users/niko/Sites/casperjs, using slimerjs version 0.8.0
 
 You are now ready to write your :doc:`first script <quickstart>`!