Usage:
       s3 [--usage] [--help] [--man] [--version]

       # generic options, valid for all commands
       s3 <command> [--id <id>] [--secret <string>] [<options...>]

       # "pure" commands
       s3 acl    [--clear] [--add <spec>] [--del <spec>] <s3path>

       s3 add    [--meta <meta>] [--header <header>] [--acl <acl>]
                 [--data <data>] [--location <place>] <s3path> [<filename>]

       s3 copy   [--meta <meta>] [--header <header>] [--acl <acl>]
                 <s3path-src> <s3path-dst>

       s3 create [--acl <acl>] [--location <location>] <bucket-name>

       s3 delete <s3path>

       s3 get    <s3path> [<filename|dirname>]

       s3 list   [--ls] [-l] [--delimiter <string>] [--max-keys <n>]
                 [--marker <n>] [<s3path>]

       s3 locate <s3path>

       s3 meta   [--clear] [--add <spec>] [--del <spec>] <s3path>

       s3 show   <s3path>

       # "filesyste-oriented" commands
       s3 cat [<filename|s3path>] ...

       s3 cp  <src> [<src2> [<src3 ...]] <dst>

       s3 dir [--delimiter <string>] [--max-keys <n>]
              [--marker <n>] [<s3path>]

       s3 ls  [-l] [--delimiter <string>] [--max-keys <n>]
              [--marker <n>] [<s3path>]

       s3 rm  <s3path> [<s3path2> [<s3path3> ...]]

Examples:
       # list all buckets
       s3 list

       # create two buckets
       s3 create mybucket
       s3 add mybucket-x

       # locate a bucket
       s3 localte :mybucket

       # list keys
       s3 list :mybucket
       s3 list :mybucket/some/prefix
       s3 ls :mybucket/some/directory
       s3 ls -l :mybucket/some/directory/extended-print
       s3 dir :mybucket/ditto/as/above

       # create a key
       s3 add :mybucket/empty
       s3 add :mybucket/cmdline-data --data 'Hello, World!'
       s3 add :mybucket/fromfile /path/to/somefile

       # get contents of one or more keys
       s3 get :mybucket/key
       s3 get :mybucket/tofile /path/to/destination
       s3 cat :mybucket/key :mybucket-x/key-x

       # make copies...
       s3 copy :mybucket/source :mybucket-x/destination-copy
       s3 cp /path/to/localfile :mybucket/remote
       s3 cp /local/file :mybucket/remote/file /path/to/localdir
       s3 cp /local/file :mybucket/remote/file :mybucket-x/path/to/remotedir/

       # move stuff
       s3 mv :mybucket/something /path/to/local
       s3 mv /path/to/something :mybucket/remote
       s3 mv /local/file :mybucket/remote/file :mybucket-x/path/to/remotedir/

       # get headers
       s3 show :mybucket/somekey

       # get/set metadata
       s3 meta :mybucket/somekey
       s3 meta :mybucket/somekey --add colour:green --del taste:awful

       # get/set ACL
       s3 acl :mybucket
       s3 acl :mybucket/somekey
       s3 acl :mybucket/somekey --add any:read --del foo@example.com

       # finally, delete stuff
       s3 delete :mybucket/somekey
       s3 delete :mybucket-x
       s3 rm :mybucket