Updating the README & changing its format to org-mode.
Another minor tidy of the Java file.