Minor modifications and clean-up for javadoc documentation

Wow, Maciej, this looks really good! 

I went through most of the files and made some small (mostly grammatical) corrections. 

Unfortunately, I haven't had a lot of sleep this week, so it wasn't able to check the content all the time, but it looks pretty good.