cleaned up the comments & descriptions a bit
Merge pull request #1 from tzikis/master

cleaned up the comments & descriptions a bit