Add "Installation" section. Add comments specific to Mac OSX file truncation issue and $JAVA_HOME issue.