Comments on update()

The comments for `@param new_instance` and `@param old_instance` were switched.
Merge pull request #22 from frebro/master

Comments on update()