breathing some life into this script. updating incorrect --help/README and some other docs.