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

All missing Javadoc covered except for DBEncoder/Decoder-related classes.
It's already deprecated, so say instead it may be removed in a future release