add deprecated/return sections.
add errors when bson_error_t is set.