Fixed documentation of return value for BSONObject.put to indicate that it returns the previous value associated with the given key.

  JAVA-1502
Ported some Javadoc changes from master to LazyBSONObject