The previous javadoc was a bit more precise regarding the purpose of the method.