Added new method `put` to the Filesystem class.

Fixed one wrong test against `write`.
Fixed some phpDoc.
[Readme] Added example of `put`.
Merge pull request #12 from marcj/master

Added new method `put` to the Filesystem class.