I've just finished a massive overhaul of the S3 PHP Class documentation.

This update includes examples for every method (none of which have been tested). If you find any errors or inconsistencies, please drop me a line.