Updating docs to reflect the new build setup
Build now returns Unix error code if tests fail

Helps with Travis-CI integration, so that failed tests imply a failed
build