Co-authored-by: Roberto C. Sánchez <roberto@connexer.com>

- Remove a lot of variable capture that was relied upon when generating
- The _LIBRARY/_LIBRARIES variables in the legacy packages now point to
  the imported target of their respective packages, which will handle
  all other "magic variable" definitions.

* Cleanup and relocate BUILD_VERSION calculation
- The computation of BUILD_VERSION is now lifted above project(), which allows
  us to use that value in the project() call itself, giving us correct
  PROJECT_VERSION values throughout.
- Define BUILD_VERSION using mongo_setting(), and use the
  calc_release_version.py to compute its default value.

* Don't set a BUILD_VERSION cache var

- The computation of BUILD_VERSION is now lifted above project(), which allows
  us to use that value in the project() call itself, giving us correct
  PROJECT_VERSION values throughout.
- Define BUILD_VERSION using mongo_setting(), and use the
  calc_release_version.py to compute its default value.

* New CMake-based uninstall generation
* Fix: Don't use genex in places where old CMake can't use it

Co-authored-by: Roberto C. Sánchez <roberto@connexer.com>

* Update Poetry and requests
* Hold back PyYAML to avoid Cython errors

This fixes an issue on newer Python installs that don't have distutils handy, as well as address a dependabot PR that could not merge correctly (#1284). Also, hold back PyYAML to avoid Cython-related issues (fixed in PyYAML 6, but Shrub requires PyYAML 5)

* New documentation with new theming
* Prettier structure and output:
- Use subdirectories for organization.
- Import sphinx-design, which gives us useful components for richer HTML output.

* Migrate most of the installation docs away:
- New install docs and "supported platforms" have been refactored and
  replaced.
- The old "installing" page has been detached from the ToC and is now
  a placeholder referencing the new documentation pages. This will allow
  existing links in the wild to continue to work, while making the page
  itself invisible in the ToC tree.
* Create a howto on selecting an installation location
* Clean up and clarify platform support
* No dep on sphinxcontrib-moderncmakedomain:

Add a very minimal Sphinx extension sufficient to resolve references to
the CMake Sphinx object inventory. We don't need any more features for
now.

* Fix up package builds to install sphinx-design deps
* Vendor external inventories semi-automatically.

To support fully-offline builds of the documentation, vendor external
documentation inventories for intersphinx. These can be updated by
passing '-D update_external_inventories=1' to the sphinx-build command

(Debian packaging) ignore lintian warnings regarding poetry since poetry is not used for debian packaging

* Revert commit ac436db8.

* Depend on XSI-compliant strerror_l instead of strerror_r

* add a failing test for CDRIVER-4666

* assert single_threaded

* remove locks during single-threaded scanning

Fixes a possible recursive mutex lock in some error scenarios. Refer: CDRIVER-4666

* format mongoc-counters-private.h

* remove unused `node_id`

resolves warning treated as error causing a task failure in the debug-compile-rdtscp task

* add index-management tests

From PR https://github.com/mongodb/specifications/pull/1442

* add test search operations and implement without helpers

* document management of search indexes

Bumps [certifi](https://github.com/certifi/python-certifi) from 2023.5.7 to 2023.7.22.
- [Commits](https://github.com/certifi/python-certifi/compare/2023.05.07...2023.07.22

)

---
updated-dependencies:
- dependency-name: certifi
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* CDRIVER-4699 add regression test

* Call `_mongoc_scram_destroy` when resetting auth state

* only call if `MONGOC_ENABLE_CRYPTO` is defined

`_mongoc_scram_destroy` is conditionally defined. If `MONGOC_ENABLE_CRYPTO` is not defined, scram auth is not supported.

Fix test failures where a large platform string caused handshake truncation

This is not a bug. The duplicate call to `_mongoc_http_response_cleanup` does not currently result in a double free.
Nonetheless, the duplicate call may result in a double free if the implementation of `_mongoc_http_send` changes in the future.

Follow up for ba5ab6de

* assert return of `mcd_rpc_message_to_iovecs`

Current implementation is expected not to return `NULL`.
`BSON_ASSERT` is added for consistency with other calls and to future-proof.

* assert return of `mcd_rpc_message_to_iovecs` in mock server

* document and test `bson_uint32_to_string` behavior when input buffer is too small.
* add `ASSERT_BSON_EQUAL_BSON` test macro
* add `bson_array_builder_t`
* add `bson_array_builder_append_*` functions
* use `bson_array_builder_t`
Replace existing use of `bson_append_array_begin`.
bcon-speed.c was deliberately not modified to use `bson_array_builder_append_array_begin` to avoid changing performance.

* move tutorial `Appending BSON` example code to separate file
* add doc page for `bson_array_builder_t` and update doc examples
* link to `bson_array_builder_t` doc page
* colocate `BSON_APPEND_*` macros with functions
Intends to make it easier to spot if a macro is missing.
* add `BSON_APPEND_ITER` and `BSON_APPEND_NOW_UTC`
* colocate `bson_append_*` with `bson_array_builder_append_*` functions
Intends to make it easier to spot if a function is missing.

---------

Co-authored-by: Adrian Dole <donald@dole.tech>

* Fix parallel Sphinx builds when building man output
* Don't use vendored theme
* Remove vendored theming
* Update SphinxBuild.cmake for newer CMake and to use parallel builds
* Update Sphinx version
* Fix: Documentation version was garbled by debug output
* Use the dirhtml builder:

Generates "prettier" URLs. To support the old URLs, also generate HTML
files that cause a redirect to the new URLs.

* Use the "furo" theme.

* CDRIVER-4679 Prefer XSI-compliant strerror_r when available

* Use CheckCSourceCompiles to test for XSI-compliant strerror_r