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

All missing Javadoc covered except for DBEncoder/Decoder-related classes.
Deprecation details are on the superclass