Merge pull request #322 from tseaver/166-document_exceptions_for_connection_create_bucket

Fix #166: Document exceptions (currently) raised from 'Connection.create_bucket'.

Author: tseaver

gcloud/storage/connection.py

@@ -338,6 +338,8 @@ def create_bucket(self, bucket):
 
         :rtype: :class:`gcloud.storage.bucket.Bucket`
         :returns: The newly created bucket.
+        :raises: :class:`gcloud.storage.exceptions.ConnectionError` if
+                 there is a confict (bucket already exists, invalid name, etc.)
         """
         bucket = self.new_bucket(bucket)
         response = self.api_request(method='POST', path='/b',