Add documentation for listing API

Add parameter to define for the sorting criteria of the returned blobs. @xla 
A better suited place for enforcing limits would be in the `FileSystem` implementation. Pushing down the responsibility means the concrete implementation can find the most efficient way to do return a limited set of files. I'd extend the `List` signature: `List(b *bucket, prefix string, limit int) ([]File, error)`.