Adding clarifying javadoc for a confusingly-named method