certainly needs JavaDoc (something on the lines of your comment on the pull request).