[JAVA-1410] Updating Javadoc for legacy public API. Added Javadoc for missing classes and methods, and for the com.mongodb package, but also updated content and formatting for some of the key existing functionality.
[JAVA-1410] Javadoc for Legacy API. Added missing javadoc, tidied some of the existing (particularly capitalisation), renamed some parameters for ease of reading.  Also removed the UnknownHostException that is declared on a lot of the Mongo methods as this is never actually thrown.
[JAVA-1410] Fixes from Ross's suggestions: updated docs for createCollection, removed a duplicate test for createCollection and added a new test to show what happens if the collection already exists.
[JAVA-1410] Fixes from Ross's suggestions: tidying DBCursor code.
[JAVA-1410] Fixes from Jeff's suggestions: improvements to the documentation contents and added test for getCollectionFromString which disappeared in the 3.0 migration.
Merge pull request #243 from trishagee/JAVA-1410

JAVA-1410: First batch of Javadoc for legacy API
[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