Document more thoroughly; add sample security policy and make tests work with security policy.
Some minor fixes to the README.
Some renames to bring the main branch more in line with the scala-rules branch, before putting the clojure rules on a side branch.
Refresh java policy after pointing to the new policy file.