[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.