[Python-checkins] Note that distinct argument patterns can be cached separately (GH-9298)

Fri Sep 14 03:53:23 EDT 2018

https://github.com/python/cpython/commit/902bcd9a1e2c73c6de5510b771c590b618c4c94e
commit: 902bcd9a1e2c73c6de5510b771c590b618c4c94e
branch: master
author: Raymond Hettinger <rhettinger at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018年09月14日T00:53:20-07:00
summary:
Note that distinct argument patterns can be cached separately (GH-9298)
files:
M Doc/library/functools.rst

diff --git a/Doc/library/functools.rst b/Doc/library/functools.rst
index 1b94f3396005..214d57334c8d 100644
--- a/Doc/library/functools.rst
+++ b/Doc/library/functools.rst
@@ -85,6 +85,11 @@ The :mod:`functools` module defines the following functions:
 Since a dictionary is used to cache results, the positional and keyword
 arguments to the function must be hashable.
 
+ Distinct argument patterns may be considered to be distinct calls with
+ separate cache entries. For example, `f(a=1, b=2)` and `f(b=2, a=1)`
+ differ in their keyword argument order and may have two separate cache
+ entries.
+
 If *maxsize* is set to ``None``, the LRU feature is disabled and the cache can
 grow without bound. The LRU feature performs best when *maxsize* is a
 power-of-two.
