remove un-necessary directive

Author: picnixz

Doc/library/intro.rst

@@ -48,18 +48,6 @@ this material.
 Let the show begin!
 
 
-.. _requirements-notes:
-
-Notes on requirements
-=====================
-
-* A "Requirements: OpenSSL >= 3.5" note means that this function requires
-  that Python has been built with OpenSSL 3.5 or later.
-
-* A "Requirements: not AWS-LC" note means that this function is not available
-  if Python has been built with AWS-LC instead of OpenSSL.
-
-
 .. _availability:
 
 Notes on availability
@@ -77,6 +65,13 @@ Notes on availability
   *Availability: Linux >= 3.17 with glibc >= 2.27* requires both Linux 3.17 or
   newer and glibc 2.27 or newer.
 
+* "Availability" notes may also be used to indicate requirements on how Python
+  was built. For instance, "Availability: OpenSSL >= 3.5" note means that the
+  feature is available if Python has been built with OpenSSL 3.5 or later,
+  while "Availability: not AWS-LC" note means that the feature is not available
+  if Python has been built with AWS-LC instead of OpenSSL.
+
+
 .. _wasm-availability:
 
 WebAssembly platforms

Doc/library/ssl.rst

@@ -232,7 +232,7 @@ Signature algorithms
    :meth:`SSLContext.set_client_sigalgs` and
    :meth:`SSLContext.set_server_sigalgs` methods.
 
-   .. requirements:: OpenSSL >= 3.4
+   .. availability:: OpenSSL >= 3.4
 
    .. versionadded:: next
 
@@ -1320,7 +1320,7 @@ SSL sockets also have the following additional methods and attributes:
    Return the group used for doing key agreement on this connection. If no
    connection has been established, returns ``None``.
 
-   .. requirements:: OpenSSL >= 3.2
+   .. availability:: OpenSSL >= 3.2
 
    .. versionadded:: next
 
@@ -1330,7 +1330,7 @@ SSL sockets also have the following additional methods and attributes:
    authentication on this connection, or ``None`` if no connection has been
    established or client authentication didn't occur.
 
-   .. requirements:: OpenSSL >= 3.5
+   .. availability:: OpenSSL >= 3.5
 
    .. versionadded:: next
 
@@ -1340,7 +1340,7 @@ SSL sockets also have the following additional methods and attributes:
    handshake on this connection, or ``None`` if no connection has been
    established or the cipher suite has no signature.
 
-   .. requirements:: OpenSSL >= 3.5
+   .. availability:: OpenSSL >= 3.5
 
    .. versionadded:: next
 
@@ -1718,7 +1718,7 @@ to speed up repeated connections from the same clients.
    :const:`True` this method will also return any associated aliases such as
    the ECDH curve names supported in older versions of OpenSSL.
 
-   .. requirements:: OpenSSL >= 3.5
+   .. availability:: OpenSSL >= 3.5
 
    .. versionadded:: next
 
@@ -1787,7 +1787,7 @@ to speed up repeated connections from the same clients.
       sockets will return the signature algorithm used for performing
       certificate-based client authentication on that connection.
 
-   .. requirements:: not AWS-LC
+   .. availability:: not AWS-LC
 
    .. versionadded:: next
 

Doc/tools/extensions/availability.py

@@ -42,11 +42,16 @@
     "glibc",
     "musl",
 })
-_THREADING = frozenset({
+_EXTRAS = frozenset({
     # POSIX platforms with pthreads
     "pthreads",
+    # SSL backends
+    "OpenSSL",
+    "AWS-LC",
+    "LibreSSL",
+    "BoringSSL",
 })
-KNOWN_PLATFORMS = _PLATFORMS | _LIBC | _THREADING
+KNOWN_PLATFORMS = _PLATFORMS | _LIBC | _EXTRAS
 
 
 class Availability(SphinxDirective):