Added changelog entry and a javadoc comment chrisin's PR.