Updated javadoc to reflect change in API behavior