diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst index 221c0712c7c96a..5c4f9a9319e529 100644 --- a/Doc/library/functools.rst +++ b/Doc/library/functools.rst @@ -718,6 +718,12 @@ The :mod:`functools` module defines the following functions: The same pattern can be used for other similar decorators: :deco:`staticmethod`, :deco:`~abc.abstractmethod`, and others. + ``singledispatchmethod`` always dispatches on the first argument passed at call + time, irrespective of whether the method is bound or unbound. As a result, + calling the method through an instance or through the class may result in + different dispatch behavior. This behavior is required to support correct + dispatch when used with ``staticmethod`` and ``classmethod``. + .. versionadded:: 3.8 .. versionchanged:: 3.15