although I'm not entirely sure what the difference is between the AWSS3Client the docs are using, and the S3Client that I've used
One is the API-specific client, the other the provider-specific client (see [1]). I.e. S3Client should work with all "S3-compatible" providers, whereas the AWSS3Client could expose extra functionality that *only* Amazon offers.
Hope that helps! ap PS: PRs to update outdated docs much appreciated...thanks! [1] http://jclouds.apache.org/start/concepts/