Added javadoc to shuffle(...)