The javadocs for the return value of the BasicDBObject.append method says that it returns the "val" argument. But in reality it returns "this". The actual return type is correct. This is just a javadoc issue.

Chers,
Leif