removing incorrect comments
better docstring for the -r option