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.
Nested <p> tags are also invalid - we should really use a <div> to wrap the <p>'s if Javadoc doesnt automatically do that.