Update docstring for 'Connection.save_entity'.

tseaver · tseaver · commit ef535364d257 · 2014-10-17T12:03:43.000-04:00
Indicate that upsert clears existing properties before applying those passed to the API. Fixes #167.
diff --git a/gcloud/datastore/connection.py b/gcloud/datastore/connection.py
@@ -338,6 +338,10 @@ def commit(self, dataset_id, mutation_pb):
     def save_entity(self, dataset_id, key_pb, properties):
         """Save an entity to the Cloud Datastore with the provided properties.
 
+        .. note::
+           Any existing properties for the entity will be cleared before
+           applying those passed in 'properties'.
+
         :type dataset_id: string
         :param dataset_id: The dataset in which to save the entity.
 
