The deprecated binary subtype 2 has a redundant length prefix at the
start of the data, check it agrees with the total BSON element length.

Don't replace all "()" with "(3)", and fix some <output> formatting.

Mallard lines like "Optional <code>bson_t</code>. Might be NULL." was
output as:

Optional
.B bson_t
. Might be NULL.

Groff misinterprets, and truncates at the first period. Escape the dot:

Optional
.B bson_t
\[char46] Might be NULL.

The BSON array keys produced from parsing JSON like this:

[{$numberLong: "123"}, {$numberLong: "456"}]

Had been "1", "3" instead of the correct "0", "1".

Revealed occasionally by test_bson_iter_fuzz with address sanitizer.

CDRIVER-1044: passing an object that undergoes default argument promotion to 'va_start' has undefined behavior