Add comments pointing to specific ACL-related methods.

tseaver · tseaver · commit 89c80fa2e603 · 2014-10-31T13:02:05.000-04:00
Incorporates feedback from @dhermes.
diff --git a/gcloud/storage/bucket.py b/gcloud/storage/bucket.py
@@ -349,6 +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'.
         if field in ('acl', 'defaultObjectAcl'):
             return default
 
diff --git a/gcloud/storage/key.py b/gcloud/storage/key.py
@@ -342,6 +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'.
         if field == 'acl':
             return default
 
