JAVA-1410: Javadoc for legacy API

Made a first pass through the com.mongodb package and the existing API classes.  I've added some jira tickets for missing tests and code we might be able to delete, and updated the [Jira ticket](https://jira.mongodb.org/browse/JAVA-1410) with the classes that I couldn't document without help.
Sure.  But I can't think of any other way to phrase it: DBCursor contains a much more detailed explanation of how that works.