CDRIVER-5696 deprecate ENABLE_SASL=CYRUS on Windows (#1729)

* CDRIVER-5696 deprecate `ENABLE_SASL=CYRUS` on Windows

* and deprecate `CYRUS_PLUGIN_PATH_PREFIX`

Author: kevinAlbs

CMakeLists.txt

@@ -149,12 +149,20 @@ mongo_setting(
       if(ENABLE_SASL STREQUAL "SSPI" AND NOT WIN32)
          message(WARNING "ENABLE_SASL=SSPI is only supported on Windows platforms")
       endif()
+      if(ENABLE_SASL STREQUAL "CYRUS" AND WIN32)
+         message(DEPRECATION "ENABLE_SASL=CYRUS on Windows platforms is deprecated and may be removed in a future major release")
+      endif()
    ]]
 )
 
 mongo_setting(CYRUS_PLUGIN_PATH_PREFIX "An absolute path prefix to enable loading Cyrus SASL plugins on Windows"
    TYPE STRING
    VISIBLE_IF [[ENABLE_SASL STREQUAL "CYRUS" AND WIN32]]
+   VALIDATE CODE [[
+      if (CYRUS_PLUGIN_PATH_PREFIX)
+         message(DEPRECATION "CYRUS_PLUGIN_PATH_PREFIX is deprecated and may be removed in a future major release")
+      endif ()
+   ]]
 )
 
 mongo_setting(ENABLE_CLIENT_SIDE_ENCRYPTION "Enable In-Use Encryption support. Requires additional support libraries."

NEWS

@@ -32,8 +32,9 @@ Deprecated:
     * `mongoc_cursor_get_hint` is deprecated for `mongoc_cursor_get_server_id`
 
   * A future minor release plans to drop support for Visual Studio 2013.
-
   * `ENABLE_SSL=LIBRESSL` is deprecated along with `mongoc_stream_tls_libressl_new`. Support for LibreSSL may be dropped in a future major release.
+  * `ENABLE_SASL=CYRUS` on Windows platforms is deprecated. Support for `ENABLE_SASL=CYRUS` on Windows may be dropped in a future major release.
+    * The associated Windows-only option `CYRUS_PLUGIN_PATH_PREFIX` is deprecated.
 
 libmongoc 1.27.6
 ================