Expanded docs for Aws::S3::Object#upload_file.

Now documenting all of the options that are passed through
to the #put_object/#create_multipart_upload call. Also added
docs about how large files are uploaded.

Fixes #158
Resolved a pair of YARD documentation issues.