[JAVA-1410] Javadoc for com.mongodb package. 

All missing Javadoc covered except for DBEncoder/Decoder-related classes.
Two reasons - 1) I stole this from the javadoc earlier in the file and 2) the standards suggest there's no need to use code on "true/false".  But since my inclination was to add @code, I have made this change.