[3.11] gh-107619: Extend functools LRU cache docs with generators and async functions (GH-107934) (#108162)

gh-107619: Extend functools LRU cache docs with generators and async functions (GH-107934)
(cherry picked from commit 1a713ea)

Co-authored-by: Hadházy Tamás <[email protected]>
Co-authored-by: Adam Turner <[email protected]>
Co-authored-by: Kumar Aditya <[email protected]>

Author: 4 people

Doc/library/functools.rst

@@ -211,8 +211,9 @@ The :mod:`functools` module defines the following functions:
 
    In general, the LRU cache should only be used when you want to reuse
    previously computed values.  Accordingly, it doesn't make sense to cache
-   functions with side-effects, functions that need to create distinct mutable
-   objects on each call, or impure functions such as time() or random().
+   functions with side-effects, functions that need to create
+   distinct mutable objects on each call (such as generators and async functions),
+   or impure functions such as time() or random().
 
    Example of an LRU cache for static web content::