Various Javadoc improvements and corrections.

I've been exploring the rxjava source code for the last week or two in my spare time and along the way I cleaned up and made minor corrections and improvements to the Javadocs. Here's the changes if they're of interest.