Add ability to process files from stdin

- accept a list of files from stdin
- clarify examples
- clean up docstrings