Some doc improvements and build changes to the Java 8 patch.

Hey @scrapcodes I updated the documentation and made some fixes. Mind merging this into your PR?