improve doc
fixes; document new evaluation results
improve error handling
main method for easier debugging