Document that / lists passed as arguments must be empty.

Author: tseaver

gcloud/datastore/connection.py

@@ -201,13 +201,13 @@ def lookup(self, dataset_id, key_pbs, missing=None, deferred=None):
                        (or a single Key)
         :param key_pbs: The key (or keys) to retrieve from the datastore.
 
-        :type missing: list or None.
-        :param missing: If a list is passed, the key-only entities returned
-                        by the backend as "missing" will be copied into it.
-                        Use only as a keyword param.
+        :type missing: an empty list or None.
+        :param missing: If a list is passed, the key-only entity protobufs
+                        returned by the backend as "missing" will be copied
+                        into it.  Use only as a keyword param.
 
-        :type deferred: list or None.
-        :param deferred: If a list is passed, the keys returned
+        :type deferred: an empty list or None.
+        :param deferred: If a list is passed, the key protobufs returned
                         by the backend as "deferred" will be copied into it.
                         Use only as a keyword param.
 

gcloud/datastore/dataset.py

@@ -148,12 +148,12 @@ def get_entities(self, keys, missing=None, deferred=None):
         :type key: list of :class:`gcloud.datastore.key.Key`
         :param item_name: The name of the item to retrieve.
 
-        :type missing: list or None.
+        :type missing: an empty list or None.
         :param missing: If a list is passed, the key-only entities returned
                         by the backend as "missing" will be copied into it.
                         Use only as a keyword param.
 
-        :type deferred: list or None.
+        :type deferred: an empty list or None.
         :param deferred: If a list is passed, the keys returned
                         by the backend as "deferred" will be copied into it.
                         Use only as a keyword param.