* document `mongoc_bulkwrite_t`

* rename `set_hint_opt` to `set_bson_value_opt`

To reuse for the `comment` option

* use `bson_value_t` for `comment`, not `bson_t`

Matches the spec, and existing C driver representation of `comment` for other functions.

---------

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

* libmongoc: remove links to content moved to mongodb.com

The API and APM docs are linked to from mongodb.com.

* libmongoc: remove no-longer-referenced files

* libmongoc: remove `genindex`

The index page only shows one entry for `mongoc_kms_credentials_provider_callback_fn`.

* libmongoc: link to `MongoDB C Driver` page

* libmongoc: fix links to `queryable-encryption`

* libmongoc: fix links to `authentication`

* libmongoc: fix links to `bulk`

* libmongoc: fix links to `client-side-field-level-encryption`

* libmongoc: fix links to `configuring_tls`

* libmongoc: fix links to `connection-pooling`

* libmongoc: fix links to `in-use-encryption`

* libmongoc: fix links to `manage-collection-indexes`

* libmongoc: fix links to ``setting_collation_order`

* libmongoc: fix links to `tutorial_crud_operations`

* libmongoc: fix link to `bulk_operation_bypassing_document_validation`

* libmongoc: fix links to `cursors_tailable`

* libbson: remove links to content moved to mongodb.com

The API docs are linked to from mongodb.com.

* libbson: link to `MongoDB C Driver` page

* libbson: remove no-longer-referenced files

* libbson: fix links to `errors`

* libmongoc: fix links to `bson:errors`

* libmongoc: fix links to `bson:lifetimes`

* homepage: link to `MongoDB C Driver` page

* libmongoc: remove no-longer-used images

* libmongoc: remove unreferenced include

* update links in README

* update link in CONTRIBUTING.md

* fix links to community forums

* add missing "the"

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

* fix `setting_collation_order_` links

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

* fix `setting_collation_order_` in `generate-opts.py`

---------

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

* bump required libmongocrypt version to 1.10.0

* replace "Client-Side Field Level Encryption" with "In-Use Encryption" in errors and docs

"In-Use Encryption" is the umbrella term referring to both "Client-Side Field Level Encryption" and "Queryable Encryption".

* fix docs typo

Link refers to QE, but text incorrectly refers to CSFLE

* update NEWS

* bump version in script

* copy in new unified tests

* copy in new legacy spec test

* add new KMS providers to test runner

add partial support for JSON schema 1.18

* implement `encrypt` and `decrypt` operations in unified test runner

* export env vars in run-tests.sh

* update prose test 11 for named KMS providers

* add map for TLS options

Required to configure TLS options on named KMS providers

* check out libmongocrypt with changes of MONGOCRYPT-605

* update docs to reflect spec terminology

KMS provider is specified with string `<KMS provider type>` or `<KMS provider type>:<KMS provider name>`

* Fix testing instructions

Previously, following the testing instructions in CONTRIBUTING.md
results in the following error:
```
"error":"NonExistentPath: Data directory /data/db not found. Create the missing directory or specify another path using (1) the --dbpath command line option, or (2) by adding the 'storage.dbPath' option in the configuration file."
```
This adds the dbpath to the command line so that way one can copy and
paste the instructions in order to run tests.

Also, prefer to use the newer mongosh over mongo.

---------

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>

* CDRIVER-3008 fix possible leak in test

* document example use of `MONGOC_JSON_SUBTEST`

* Remove CMake code for source distribution

This removes code that accumulates lists of sources to include in the
source dist, as well as the targets which generate it.

* "RELEASE" mode does not use release archive
* link-sample tasks do not use the source archive
* No more make-release-archive
* Rename make_release_archive -> make_docs
* Rename the variant
* Define a variant tag for protecting merges
* Use stable Fedora for RPM build (for now)
* Use git archive to create the source archive
* Bring packaging tasks as PR-protected
* Tweak pkg version detection
* Tweak spec patchfile
* Get source filename from rpmspec
* Note pending removal of the release archive

* A basic Poetry project for managing dev scripts and tools
  Fixup several other scripts to be set -u safe since we now import that
  setting.
* Use Poetry to run Sphinx
* Change variant used for release archive
  The release archive build invokes Sphinx, and since Sphinx is now installed by
  Poetry, we require a newer Python version. make-release-archive now runs
  on Ubuntu 22.04
* abi-compliance-check needs u18
  The abi-compliance-check task assumes an external `abi-compliance-checker`
  tool is installed, but that is only true on the Ubuntu 18.04 EVG
  distros.
* Significant script refactoring:
- Split components into separate files, and provide a way to selectively
  import them from other scripts.
- Download install-poetry.py on-the-fly when it is needed, not committed
  into the repository.
- Add a download-file utility.
- python.sh/poetry.sh are importable to be reused in other scripts.
* Add notes about building docs to CONTRIBUTING
* Parallelize the HTML build
* Add a console script for EVG generation

* announce plan to drop macOS 10.14 and 10.15

* note testing with macOS 10.14 will be dropped

* document macOS 11.0 is tested

* document both x86_64 and arm64 are tested

* add TODO comment to drop testing of macOS 10.14 after release of 1.24.0

* refer to macOS 11.0 in "How to Ask For Help"

* refer to "Supported Platforms" in CONTRIBUTING.md

* use "upcoming" in NEWS

This does not commit to dropping in 1.25.0 in case plans change.

* remove mention of macOS 10.15

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* remove comment

* Use "an"

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

---------

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>
Co-authored-by: Roberto C. Sánchez <roberto@connexer.com>

* Sync legacy CSE test files with b3beada7

* Add legacy CSE test runner support for AWS temp creds

* Update Evergreen config to support AWS temp creds

* Print status during invocation of Drivers Evergreen Tools scripts

* Define PYTHON as PYTHON_BINARY after activate_venv.sh

* Deactivate the kmstlsenv venv environment when done

* Ensure calls to activate_venv.sh do not race on venv preparation

* Replace legacy backtick notation with dollar-parenthesis notation

* Suppress errors on chmod of build dirs

* Permit zero hosts when validating SRV loadBalanced URI before DNS query
* Add URI parsing support for srvMaxHosts
* Add documentation of MONGOC_URI_SRVMAXHOSTS to mongoc_uri_t.rst
* Add URI Options spec tests for srvMaxHosts
* Add const qualifier to _mongoc_host_list_length() parameters
* Add bounded uniform distributed random integer generators
* Fix infinite loop in dump_hosts()
* Add support for limiting initial DNS seedlist per srvMaxHosts
* Add srvMaxHosts spec tests for Initial DNS Seedlist Discovery
* Add support for limiting SRV record polling hosts per srvMaxHosts
* Add prose tests for SRV Polling
* Refactor SRV Polling prose tests to handle single vs. pooled cases

Co-authored-by: Ezra Chung <88335979+eramongodb@users.noreply.github.com>

* Enable skipping of KMS TLS tests via MONGOC_TEST_SKIP_KMS_TLS_TESTS
* Add condition for skipping KMS TLS tests on CA cert register failure
* Add CA certificate registration routines for MacOS
* Add routine to wait for mock KMS server startup completion
* Re-enable CSE tests on RHEL variants

* Support detailed certificate verify failure errors with OpenSSL
* Support detailed certificate verify failure errors with Secure Channel
* Move CSE tests into conditional compilation under MONGOC_ENABLE_SSL
* Add Client Side Encryption KMS TLS tests
* Fix CA certificate registration failure on Windows
* Fix CA certificate registration failure on Red Hat
* Add mock KMS servers to Evergreen
* Document mock KMS server requirements for CSFLE tests
* Disable CSE tests on RHEL until resolution of BUILD-14068

Several tests require use of the configureFailPoint command to trigger
server-side errors. The command must be enabled via configuration file
or command line option when starting mongod.

The configureFailPoint command is not yet documented; see DOCS-10784.

Add tasks to the Evergreen configuration based to test against a loadbalanced cluster.
- Tests with auth+SSL and with no auth+SSL on both server version 5.0 and latest.
- Runs tests against: new load balanced tests, all unified tests, retryable reads, retryable writes, change streams, and the C driver specific /loadbalanced/* tests.

Update test-libmongoc to support testing against a load balancer.
- Support the environment variable MONGOC_TEST_LOADBALANCED to enable testing against load balancers in test-libmongoc.
Support the environment variables SINGLE_MONGOS_LB_URI, MULTI_MONGOS_LB_URI to set URIs for test clients.
- Mock the serviceId when MONGOC_TEST_LOADBALANCED is true.
- Support multiple occurrences of the -l flag in test-libmongoc and alias the flag as --match.
- Remove unnecessary constraint of retryable writes tests for replica sets.

CDRIVER-4060 add remaining support to the unified test runner for the new loadbalancer spec tests.
- Iterate the first result of a FindCursor in the createFindCursor operation.
- Support appname as a URI parameter.
- Skip listening or comparing CMAP (Connection Monitoring and Pooling) events, since the C driver does not implement CMAP.

* CDRIVER-4066 "Support" version 1.2 of unified test format

Since the only tests that are using the loop operation and storeEventsAsEntities are the drivers-atlas-testing tests, we can defer implementation of those two features until the atlas testing project.

* CDRIVER-4060 Implement version 1.3 of unified test format

Note that implementing the serverless topology check will be done separately

* CDRIVER-4064 Support serverless runOnRequirement in test runner

* Avoid early exit in complex check functions

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>

* Error when encountering unsupported functionality

* Don't call result_check when ignoreResultAndError is used

* Reference CMAP ticket

* Don't require saveResultAsEntity for createFindCursor operation

* Set return value after fetching data from cursor

Co-authored-by: Kevin Albertson <kevin.albertson@10gen.com>

- Resyncs the URI options tests and the initial DNS seedlist discovery tests
- Add the loadBalanced URI option
- Validates the loadBalanced URI option after TXT records are applied
- Disable SRV polling if loadBalanced is enabled
- Add prose test to ensure SRV polling is disabled
- Consolidates DNS related tests under /initial_dns_seedlist_discovery/

* CDRIVER-3917 route all test client and client_pool creation through the test framework

* small fixes

* add missing include

* rename pool method to match client method

* Refactor test framework client factories to accept API version

* Revert change in mongoc-cache.c

Despite the #include, the linker does not like this:
tests/test-mongoc-cache.c.o: In function `ping':
src/libmongoc/tests/test-mongoc-cache.c:45: undefined reference to `test_framework_client_new'

* Run all tests with requireApiVersion=true

* Fix large_ismaster test

* Don't set server api when client can't be created

* Don't use test clients in tests specifically testing server API behaviour

* Print default API version in test output

* Set requireApiVersion option earlier

* Consider apiVersion field when assembling large bulk operation

* Fix wrong comment wording

Co-authored-by: Benjamin Rewis <32186188+benjirewis@users.noreply.github.com>

* Fix inaccurate variable name

* Remove obsolete todo

* Document MONGODB_API_VERSION environment variable in contributing docs

* Document new test methods

* Fix tests with acceptApiVersion2

* Update newly added test

Co-authored-by: samantharitter <samantha.ritter@10gen.com>
Co-authored-by: Benjamin Rewis <32186188+benjirewis@users.noreply.github.com>