finishing touches - corrections and comments