[Python-checkins] r83513 - python/branches/py3k/Doc/library/functools.rst

[raymond.hettinger]

Author: raymond.hettinger
Date: Mon Aug  2 02:59:14 2010
New Revision: 83513

Log:
Add example applications for the LRU and LFU cache docs.

Modified:
   python/branches/py3k/Doc/library/functools.rst

Modified: python/branches/py3k/Doc/library/functools.rst
==============================================================================
--- python/branches/py3k/Doc/library/functools.rst	(original)
+++ python/branches/py3k/Doc/library/functools.rst	Mon Aug  2 02:59:14 2010
@@ -59,7 +59,8 @@
    <http://en.wikipedia.org/wiki/Cache_algorithms#Least-Frequently_Used>`_
    is indicated when the pattern of calls does not change over time, when
    more the most common calls already seen are the best predictors of the
-   most common upcoming calls.
+   most common upcoming calls (for example, a phonelist of popular
+   help-lines may have access patterns that persist over time).
 
    .. versionadded:: 3.2
 
@@ -84,7 +85,9 @@
    A `LRU (least recently used) cache
    <http://en.wikipedia.org/wiki/Cache_algorithms#Least_Recently_Used>`_
    is indicated when the pattern of calls changes over time, such as
-   when more recent calls are the best predictors of upcoming calls.
+   when more recent calls are the best predictors of upcoming calls
+   (for example, the most popular articles on a news server tend to
+   change every day).
 
    .. versionadded:: 3.2