diff --git a/test/casperjs/README.txt b/test/casperjs/README.txt
new file mode 100644
index 00000000000..489c85112e4
--- /dev/null
+++ b/test/casperjs/README.txt
@@ -0,0 +1,4 @@
+This directory contains the Galaxy framework written by Carl Eberhard
+for running headless browser tests using CasperJS and PhantomJS.
+
+See notes at the top of casperjs_runner.py for more information.
diff --git a/test/casperjs/casperjs_runner.py b/test/casperjs/casperjs_runner.py
index 1104b3b2ddb..dae0a57122b 100644
--- a/test/casperjs/casperjs_runner.py
+++ b/test/casperjs/casperjs_runner.py
@@ -6,16 +6,16 @@ Tests can be run in any of the following ways:
 * casperjs test mytests.js --url='http://localhost:8080'
 * python casperjs_runner.py
 * nosetests
-* sh run_functional_tests.sh test/casperjs/test_runner
+* sh run_functional_tests.sh test/casperjs/casperjs_runner.py
 * sh run_functional_tests.sh
 
 Note: that you can enable (lots of) debugging info using cli options:
-* casperjs test usertests.js --url='http://localhost:8080' --verbose=true --logLevel=debug
+* casperjs test api-user-tests.js --url='http://localhost:8080' --verbose=true --logLevel=debug
 
 (see casperjs.org for more information)
 
-Note: This seems to not work with CasperJS 1.1 (and PhantomJS 1.9) - Casper 1.0.xx and
-PhantomJS 1.8 work for me (John).
+Note: This works with CasperJS 1.1 and PhantomJS 1.9.2 and these libraries seem to break backward
+compatbility a lot.
 
 Note: You can pass in extra data using --data='<some JSON object>'
     and it will be available in your script as spaceghost.fixtureData.