Make the iterator a bit less pathological

No need to call os.listdir() *and* then check the file exists...
More work on the docs

Expanded info on development modes and configuration. Added a man page
covering configuration