TRIVIAL: updated javadoc 

to clarify behaviour of the removeRepository method and direct users to the correct one. I fell into that trap implementing a scheduled task and want to save others the headache..