Document exceptions (currently) raised from 'Bucket.delete'.

Note that #164 would change this (by adding fine-grained exceptions
for 409, 401, etc.).

Fixes #159 (but should be revisited if #164 lands).
Document exceptions (currently) raised from 'Connection.create_bucket'.

Note that #164 would change this (by adding fine-grained exceptions
for 409, 401, etc.).

Fixes #166 (but should be revisited if #164 lands).
Rename key iterators to indicate they are implementation details of Key.

Rename 'key.KeyIterator' -> 'key._KeyIterator'

Move / rename 'iterator.KeyDataIterator' -> 'key._KeyDataIterator'.

Fixes #244.
Merge pull request #322 from tseaver/166-document_exceptions_for_connection_create_bucket

Fix #166: Document exceptions (currently) raised from 'Connection.create_bucket'.
Merge pull request #321 from tseaver/159-document_exceptions_for_bucket_delete

Fix #159: Document exceptions (currently) raised from 'Bucket.delete'.
Fixing corner case where lint doesn't run outside of a PR.
Merge pull request #323 from tseaver/244-rename-key_data_iterator-not_api

Fix #244: Rename key iterators to indicate they are implementation details of Key.
Merge pull request #325 from dhermes/make-lint-run-always

Fixing corner case where lint doesn't run outside of a PR.
Rename upload/download methods to clarify directionality.

- 'set_contents*' -> 'upload'.

- 'get_contents* -> 'download'.

Original boto-like names retained as aliases per @jgeewax.

Fixes #148.
Merge pull request #320 from tseaver/148-rename_key_upload_download_methods

Rename upload/download methods to clarify directionality.
Allow clearing an ACL.
Add a 'loaded' flag to ACLs.

'reset()' clears it, along with entities.

'add_entity()' sets it.
Neaten.
Use ACL-specific endpoints where feasible for buckets.

- Refactor lazy-handling of 'acl' and 'default_object_acl' using properties.

- Fetch 'ac' and 'defaultObjectAcl' via GET to specific endpoints.

- Continue to update 'acl' and 'defaultObjectAcl' via PATCH to the object's
  resource (we can't do incremental updates to ACEs).

Fixes #163.
Use ACL-specific endpoints where feasible for keys.

- Refactor lazy-handling of 'acl' using a property.

- Fetch 'acl' via GET to a specific endpoint.

- Continue to update 'acl' via PATCH to the object's resource (we can't do
  incremental updates to ACEs).

Fixes #151.
Fix save/clear ACL operations.

Borked by dropping the 'projection' qs param to PATCH.  Docs spell
a default, but then note that overriding it w/ 'full' is required
(and we need 'full' anyway, because we expect to read the resulting
ACL back).
Accomodate 'stick' ACL entries when clearing bucket's ACL.

Back-end preserves some of them even after a successful PATCH with
data .
Drop support for fetching ACLs through 'metadata' operations.

We have separate APIs for ACLs, and the 'full' option was needlessly
complex, maybe even expensive.
Add comments pointing to specific ACL-related methods.

Incorporates feedback from @dhermes.
Ensure bucket's 'acl' is marked as loaded after 'save_acl'.

Incorporates feedback from @dhermes.