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.
@since 3.0 (it wasn't public in 2.x).  Please check the rest for the same mistake.