update REAME, comments, variable names