updated javadoc to clarify behaviour of the removeRepository method and direct users to the correct one
Merge pull request #840 from sonatype/javadoc

TRIVIAL: updated javadoc