Fix #167:  Update docstring for 'Connection.save_entity'.

Indicate that upsert clears existing properties before applying those passed to the API.

Fixes #167.
I've tried an alternative wording, and added and equivalent in 'Entity.save'.