Update documentation. Add some steps to building jzmq to get around some
wonkiness. Allow JAVA_HOME to be set outside of the script.
merged some changes from thecarlhall's fork