JAVA-1391: Javadoc for driver-core

Started creating Javadoc for the core module.  Started with a simple search for invalid HTML to fix, and then moved on to documenting (most) of the connection package.
I'm going to do that on the second pass.  This pass is about making sure there is documentation for all public methods and classes.