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.
For async, this may not be threads waiting.  Can we just say "the maximum number of waiters"?