report corrections and code cleaning
updating README