fix javadocs to correctly reflect refactored code