more error reporting and updated README