Fix for BasicBSONObject equals method

very large Long values were being converted to doubles for comparison
and incorrectly considered equals
Improve javadoc of JSON.parse() and JSONParseException.
JAVA-838: deprecate DB.authenticate
JAVA-875: deprecate JMX mechanism
JAVA-878: deprecate DB#setReadOnly()
JAVA-877: move org.bson.LazyDBList to com.mongodb
JAVA-900: deprecate c.m.WriteResult.getLastError(WriteConcern)
JAVA-904: drop support of BSON DBPointer type
JAVA-897: deprecate DBConnector & DBApiLayer
JAVA-896: deprecate exceptions nested under DBPortPool & MongoException
JAVA-874: deprecate {com.mongodb,org.bson}.util classes
JAVA-839: update ObjectId api

Deprecated:
- ObjectId(java.util.Date, int, int)
- ObjectId(String,boolean)
- ObjectId(int,int,int)
- toStringMongod()
- toStringBabble()
- babbleToMongod()
- getTimeSecond()
- getMachine()
- getInc()
- getGenMachineId()
- getCurrentInc()
- getTime()
- isNew()
- notNew()
- massageToObjectId(Object)
- _flip(int)
- _inc()
- _machine()
- _time()

Added:
- toHexString()
- getTimestamp()
- getDate()
- getCurrentCounter()
JAVA-880: deprecate several methods in o.b.i.OutputBuffer
JAVA-881: deprecate direct access to fields of DBCollection
JAVA-882: deprecate several methods in c.m.Mongo

Changes:
- deprecate getMinorVersion()
- deprecate getMajorVersion()
- deprecate debugString()
- deprecate connect(com.mongodb.DBAddress)
- deprecate Holder.connect(MongoURI)
- add Holder.connect(MongoClientURI)
JAVA-895: deprecate protected members of org.bson.BasicBSONDecoder
JAVA-894: deprecate write* & _put* BasicBSONEncoder methods
JAVA-893: deprecate classes and methods that will be excluded from 3.x
docs: update several deprecated comments
JAVA-901: cleanup org.bson.Lazy*