some readme and comment fixes