bson_t->allocated should represent entire allocation size.

This means that it includes the size of the structure too.
add description to bson_t fields.