comment client program better
moar commenting!
update readme a little
merging in changes from master