added comments, example and a file with a sample run