Add documentation for top-level S3 module

The docs are missing content for functions in the top of the boto.s3 module.