Make 'get_metadata' comments more developer-centric.

tseaver · tseaver · commit 4dde9cb1230f · 2014-10-31T13:54:18.000-04:00
diff --git a/gcloud/storage/bucket.py b/gcloud/storage/bucket.py
@@ -349,8 +349,8 @@ def get_metadata(self, field=None, default=None):
         :rtype: dict or anything
         :returns: All metadata or the value of the specific field.
         """
-        # Use 'get_acl()' to retrieve the 'acl', and 'get_default_object_acl()'
-        # to retrieve the 'defaultObjectAcl'.
+        # We ignore 'acl' / 'defaultObjectAcl' because they should be
+        # handled via 'get_acl()' / 'get_default_object_acl()'
         if field in ('acl', 'defaultObjectAcl'):
             return default
 
diff --git a/gcloud/storage/key.py b/gcloud/storage/key.py
@@ -342,7 +342,7 @@ def get_metadata(self, field=None, default=None):
         :rtype: dict or anything
         :returns: All metadata or the value of the specific field.
         """
-        # Use 'get_acl()' to retrieve the 'acl'.
+        # We ignore 'acl' because it is meant to be handled via 'get_acl()'.
         if field == 'acl':
             return default
 
