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

Indicate that upsert clears existing properties before applying those passed to the API.

Fixes #167.