* deprecate `*_hint` functions for newly added `*_server_id` functions

* call `*_server_id` functions from `*_hint`

* update calls to use new `*_server_id` functions

* update docs

* update NEWS

* 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

* include more info in error message

* add regression test for reading incomplete chunk

* CDRIVER-5506 error if reading an incomplete chunk

Fixes a possible hang when `mongoc_gridfs_file_readv` is called with a corrupt interior chunk sized smaller than `chunk_size`.

Implementation assumes chunks (excluding the last chunk) are of size `chunk_size` for calcluating offsets.

* CDRIVER-5511 disable loading Cyrus plugins on Windows by default

adds the CMake option `CYRUS_PLUGIN_PATH_PREFIX` to opt-in to loading plug-ins

---------

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

* bump VERSION_CURRENT from `1.26.0` to `1.27.0-dev`

* update NEWS for 1.26.0 release

* 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

* document removal of BUILD_VERSION

* apply `BUILD_VERSION` from CMake option if specified

* update NEWS

* update NEWS for 1.25.0

* link to GitHub release page, not tarball

The tarball is removed in 1.25.0 as part of CDRIVER-4640.

* move `:man_page:` directive

Appears to fix HTML rendering. Cause is not known.

* CDRIVER-4591 macos-1014 -> macos-1100 in Evergreen config

Also, no x509 SSL client auth test on darwin

* CDRIVER-4660 drop ubuntu1404 from Evergreen config

* CDRIVER-4661 drop debian8 from Evergreen config

* CDRIVER-4591 macos-1014 -> macos-1100 in Evergreen config, 2

* Document the obsolete platforms that were dropped

* 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

* copy NEWS for 1.24.0

* add NEWS for 1.24.1

Resolves CDRIVER-4542 and CDRIVER-4541.

* move Unreleased section of NEWS to the top

* document intent to drop support

* separate sections

* New config settings code and defaults.

Almost all setting values have remained the same, and most setting
handling logic has remained unmodified, but this will serve as a basis
for better configuration settings handling in the future tasks for
CDRIVER-4637.

* Aside: message() cleanup

Using `message()` without a mode argument will write the message
as a NOTICE to stderr. We want to use STATUS as the default, which goes
to stdout. Systems which colorize stderr output would seemingly-randomly
color certain lines where the mode argument was missing.

* Use new CMake in more build tasks

Several build tasks still relied on older find-cmake logic. With the
new CMake changes, a more recent CMake version is required. These
tasks and scripts have been updated to use the same logic to find
the same CMake version as is used in the main build tasks.

* Don't use Batch scripts to compile for MinGW

Batch scripting is fraught with peril and will almost never do what
one expects. Any other scripting language is preferable. Since we have
Bash available and the tools to properly convert paths, just use Bash
to do this work.

* Redundant ENABLE_SHM_COUNTERS logic
* Update the "Ask for Help" section
* No longer applicable SASL checks
* Remove ENABLE_BSON, as its purpose is confusing.
- ENABLE_BSON=ON did the same as ENABLE_BSON=AUTO
- There is no "ENABLE_BSON=OFF" since then there would be nothing to build.
- USE_SYSTEM_LIBBSON=ON replaces ENABLE_BSON=SYSTEM.
- To alleviate downstreams from needing to check versions before configuring,
  allow ENABLE_BSON=SYSTEM to be specified if USE_SYSTEM_LIBBSON=ON is also set,
  thus allowing one option pair to build both before and after this revision.
- If ENABLE_BSON=SYSTEM is set but USE_SYSTEM_LIBBSON is not TRUE, then
  downstream will want to update their scripts to build with the new
  option rather than miscompile without being noticed.
* New toolchain for the build
* Don't inject the toolchain SSL into LD_LIBRARY_PATH

The toolchain CMake is incompatible with OpenSSL 1.1.0, so having it on the
library path breaks CMake. We don't need to modify LD_LIBRARY_PATH to cause
CMake to use the OpenSSL that we want. It is sufficient to prepend the SSL root
to the CMAKE_PREFIX_PATH.

* Coverage link options are usage requirements
* More Bash, less Sh
* Don't depend on distro_id

* fix link to libbson package on fedoraproject.org

* update links from "Command Monitoring" spec to newly named "Command Logging and Monitoring" spec

* fix links to server errors

* fix "canonical" link for libmongoc docs

* apply regex replacement from DRIVERS-2249

* 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>

* update NEWS for 1.22.0-beta0

* add required notes