Agree javadoc comment would be useful here.