added comments, updated README
minor changes