Merge pull request #83 from julen/doc-fixes

Docs: docstring fixes
Added readmes for examples
Use detach for TextIOWrapper.  See http://bugs.python.org/issue21363
read1 calls into read now but line buffering gets enabled.
Added a base command for dispatching to other parsers.
Added support for lists from envvars.  This fixes #87
Apply the same splitting logic for explicit envvars
Also added support for nargs != for values from environment.
Added multi envvar docs
Fixed a broken example
Fixed lack of clear reporting for paths
Added filename format function
Added a complex example for plugin loading.
Updated README for complex apps
Updated the example
Docs: fixes