gh-72570: mention the incompatibility of XOFs with HMAC (#136676)

picnixz · web-flow · commit a02cf19deed3 · 2025-07-15T14:03:21.000+02:00
diff --git a/Doc/library/hmac.rst b/Doc/library/hmac.rst
@@ -12,6 +12,9 @@
 --------------
 
 This module implements the HMAC algorithm as described by :rfc:`2104`.
+The interface allows to use any hash function with a *fixed* digest size.
+In particular, extendable output functions such as SHAKE-128 or SHAKE-256
+cannot be used with HMAC.
 
 
 .. function:: new(key, msg=None, digestmod)
