[JAVA-1391] Updating Javadoc to a) pass checkstyle check for Javadoc on public classes & methods and b) not fail under Java 8 Javadoc generation.  Added a test to document WriteConcern throwing ClassCastException under certain circumstances
[JAVA-1391] Updating Javadoc to a) pass checkstyle check for Javadoc on public classes & methods and b) not fail under Java 8 Javadoc generation.  Added package-info.java for packages that were touched.  Added @since tags where the right version was known.
[JAVA-1391] Updating Javadoc for connection package to pass checkstyle check for Javadoc on public classes & methods.  Added @since tags where the right version was known. Applied consistency around use of final keyword according to our agreed standards.
[JAVA-1391] Updating Javadoc for connection package to pass checkstyle check for Javadoc on public classes & methods.  Added @since tags where the right version was known.
[JAVA-1391] Applying suggestions from pull request review.
[JAVA-1391] Fixes from Ross's suggestions.
[JAVA-1391] Fixed all errors for generating Javadoc using Java 8, so Java 8 can now be used to build; in the classes that were touched by this, added missing Javadoc and tried to apply standard HTML formatting to more descriptive sections (e.g. lists instead of tables).
[JAVA-1391] Fixed groovy for new codenarc settings
Merge pull request #242 from trishagee/JAVA-1391

JAVA-1391: Javadoc for driver-core, first batch of documentation