Clarify why 'reload_metadata' uses 'projection=noAcl'.

tseaver · tseaver · commit a4bb7093c56d · 2014-10-31T14:12:19.000-04:00
diff --git a/gcloud/storage/bucket.py b/gcloud/storage/bucket.py
@@ -328,6 +328,8 @@ def reload_metadata(self):
         :rtype: :class:`Bucket`
         :returns: The bucket you just reloaded data for.
         """
+        # Pass only '?projection=noAcl' here because 'acl'/'defaultObjectAcl'
+        # are handled via 'get_acl()'/'get_default_object_acl()'
         query_params = {'projection': 'noAcl'}
         self.metadata = self.connection.api_request(
             method='GET', path=self.path, query_params=query_params)
diff --git a/gcloud/storage/key.py b/gcloud/storage/key.py
@@ -321,6 +321,8 @@ def reload_metadata(self):
         :rtype: :class:`Key`
         :returns: The key you just reloaded data for.
         """
+        # Pass only '?projection=noAcl' here because 'acl' is handled via
+        # 'get_acl().
         query_params = {'projection': 'noAcl'}
         self.metadata = self.connection.api_request(
             method='GET', path=self.path, query_params=query_params)
