fixed help scope from dist merge, added descriptive error messages, improved readme