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

Signed-off-by: A. Jesse Jiryu Davis <jesse@mongodb.com>

bson_append_code_with_scope now preserves the "code with scope" type
if scope is an empty, non-NULL BSON document.

bson_as_json now properly formats BSON "code" and "code with scope"
types like '{"$code": "...", "$scope": {}}'. Before, it had treated the
code as a string and ignored the scope.