JavaDoc clarification, updated README w/ release notes