minor fixes, updated README a bit, added javadocs to API methods, added
usage.txt for information about Realms, fixes #3