[Brightbox] Rename old destroy requests to delete

To standardised with the Delete in CRUD we decided to update the API
documentation but had used the old names in the Fog requests.

This replaces them with deprecation to the old methods so they continue
to work as before.
[Brightbox] Documentation fixes

Fixes yardoc for request methods.
Merge pull request #1818 from fog/brightbox_updates

[Brightbox] Updates to delete requests and doc fixes
Remove spurious warning...

This removes a warning that is outputed by Fog when a S3 bucket name
contains a period. This resulted in excessive logging of a condition when
using Fog to push to a S3 bucket configured to serve a web site. See
fredjean/middleman-s3_sync#10 to see the issue that triggered this commit.