Bugfixes. Doc changes.

- Bugfix with file-handling.
- Bugfix with StringIO under Python3.
- Added real-world examples to doc.