javadocs to clarify update() and save() meaning