Updated javadoc for the update() method.