Synced with mongodb/specifications@5fc23f40f79d18f0693e7159eba81f0e7b276715

Updates retryable writes prose test 3 to relocate the errorLabels field when configuring a fail point.

Note: with_transaction/callback-retry.json is unrelated but was missed in CDRIVER-2975. This test currently fails and has been skipped (see: CDRIVER-4811).

Synced with mongodb/specifications@38e65fc8e59fedea351d9393ae43d305cde6ce00

This includes error-labels-blockConnection.json for client-side operations timeout, which is not yet implemented in libmongoc.

Per run-tests.sh, these tests will not actually be executed on load balancers. This is intentional to avoid making further changes to the legacy spec test runner to support LBs.

* Add trailing newline to skipped test output

Server responses do not return errorLabels within writeConcernError. It is only a top-level field.

* remove use of `:=`

Assignment expressions were introduced in Python 3.8

* use `typing.Union` instead of `|`

Writing union types as `X | Y` was introduced in Python 3.10.

* do not use Union `|` operator

The Union `|` operator was added in Python 3.9. See: PEP 584

* use `typing.List` and `typing.Dict`

Type hinting for `list`, `dict` was added in Python 3.9. See: PEP 585

Synced with mongodb/specifications@4c73bb13daa0241a3956a30b451edda10f79dde6

This pulls in some changes for CDRIVER-4639 for poc-retryable-writes.json, but other files pertinent to CDRIVER-4639 have not been synced.

Synced with mongodb/specifications@564547496b60c1f013c1a2edc27dd690f57ba04c

* support Python 3 in `parse_handshake_cfg.py`

* add numeric assignments to enum values

* format `mongoc-handshake-private.h`

* fix reference to test function

* restore `MONGOC_MD_FLAG_ENABLE_ICU`

* comment about `MONGOC_MD_FLAG_ENABLE_ICU` removal

* import older `DirectoryHTMLBuilder` if needed

The import path of `DirectoryHTMLBuilder` was changed from `sphinx.builders.html` to `sphinx.builders.dirhtml` in Sphinx v2.0.0

* import `Directive`, not `SphinxDirective`

`SphinxDirective` was added in Sphinx v2.0.0

* do not import Project

`Project` was added in Sphinx v2.0.0

* update `needs_sphinx` to 1.7

* error if `add_css_file` is unavailable for HTML builder.

But do not error otherwise. This is intended to help build man pages without HTML requirements.

`Sphinx.add_css_file` was added in Sphinx v3.5.0

* use `builder-inited`

`config-inited` was added in Sphinx v1.8.0

* do not use `external` role

`external` role was added in intersphinx extension in v4.4

* do not use `noindexentry`

`noindexentry` option was added to C domain in Sphinx v3.2

* remove `name` from `index` directive

`name` option was added in Sphinx v3.0

* populate `man_pages` in `setup` instead of event handler

The `config-inited` event was added in Sphinx v1.8.0
The `ManualPageBuilder` constructor raises an exception for an empty `man_pages` value.

* remove parallel build of man pages

To avoid an error observed on Sphinx 1.7.6:
```
AttributeError: Can't pickle local object 'BuildEnvironment._read_parallel.<locals>.merge'
```

* remove unhelpful warning

An error is raised at runtime with a message suggesting to install `sphinx-design`. The warning was a source of confusion in CDRIVER-4767

* update NEWS for 1.25.3

* add upcoming NEWS for 1.25.4

* note distinction of development packages

* fix typo

* describe how to check version

* do not require sphinx-design

sphinx-design is not used in the man pages. Do not require sphinx-design to enable building man pages when sphinx-design is not available.

* error if building HTML docs without sphinx-design

* remove `python3-sphinx` from mock install

`python3-sphinx` is listed in BuildRequires of spec file and does not need to be installed separately.

* update spec.patch to remove `python3-sphinx-design`

Intended to test the RPM build without the `python3-sphinx-design` dependency installed.

* commit staged files

This is intended to test files changed in a patch build.
Patch builds apply changes to index.

* remove ExceededTimeLimit.json

* libbson: prevent -Werror=conversion with GCC 12

Building fails with GCC 12.3:

    bson-iter.h:434:33: error: conversion from 'int64_t' {aka 'long long int'} to '__suseconds_t' {aka 'long int'} may change value [-Werror=conversion]
    434 | tv->tv_usec = (value % 1000) * 1000;
    | ~~~~~~~~~~~~~~~^~~~~~
    cc1plus: all warnings being treated as errors

Do the same as with tv->tv_sec, and explicitely cast it to suseconds_t
on non-Win32 systems and to long on Win32.

* use `time_t` in assignment to `tv_sec`

This matches specificiation in POSIX 2008.

* remove unused `gx_linkopts`

* add thread library to pkg-config libs

Co-authored-by: vector-of-bool <vectorofbool@gmail.com>

The AIX strerror_r doesn't have the same semantics as glibc's (diff type
signature), but it does provide one under a different name. This name is
used if you use -D_LINUX_SOURCE_COMPAT, but it's a big hammer. We can
just use it directly.

* Fix format specifier in timeout range validation error messages

* CDRIVER-4781 Avoid overflow of -1 sockettimeout in cast to intermediate uint32_t

* Add regression test for negative sockettimeoutms validation

* Update documentation with warnings for non-positive timeout values

* Update timeout variables for type consistency

* Add regression test for unspecified default timeout in writev functions

* Drop Debian Sphinx patch

* Update debian/changelog to reflect dropping sphinx patch