Mercurial > cpython-lru_cache-weakref

annotate Doc/lib/libcmpcache.tex @ 17581:c1937faabb23 2.1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added support for optional explanation parameter to the \versionadded macro. Refactored do_cmd_versionadded() and do_cmd_versionchanged() to do most of the work in a helper function, with the do_cmd_*() wrappers just supplying a portion of the replacement text.
author Fred Drake <fdrake@acm.org>
date Wed, 18 Apr 2001 17:29:14 +0000
parents 4b51d069be35
children 376ee174ecd0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10996
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
1 \section{\module{cmpcache} ---
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
2 Efficient file comparisons}
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
3
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
4 \declaremodule{standard}{cmpcache}
15467
d7864345b1c8 Update Moshe Zadka's email address to one works and might last a while.
Fred Drake <fdrake@acm.org>
parents: 11414
diff changeset
5 \sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}
10996
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
6 \modulesynopsis{Compare files very efficiently.}
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
7
16253
4b51d069be35 Removed references to Python 1.5.3; that was a "tentative" number I used
Fred Drake <fdrake@acm.org>
parents: 15467
diff changeset
8 \deprecated{1.6}{Use the \refmodule{filecmp} module instead.}
11414
c8155d05d9ca Added deprecation notes, in case anyone decides to read these anyway.
Fred Drake <fdrake@acm.org>
parents: 11005
diff changeset
9
11005
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
10 The \module{cmpcache} module provides an identical interface and similar
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
11 functionality as the \refmodule{cmp} module, but can be a bit more efficient
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
12 as it uses \function{statcache.stat()} instead of \function{os.stat()}
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
13 (see the \refmodule{statcache} module for information on the
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
14 difference).
10996
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
15
11005
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
16 \strong{Note:} Using the \refmodule{statcache} module to provide
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
17 \function{stat()} information results in trashing the cache
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
18 invalidation mechanism: results are not as reliable. To ensure
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
19 ``current'' results, use \function{cmp.cmp()} instead of the version
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
20 defined in this module, or use \function{statcache.forget()} to
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
21 invalidate the appropriate entries.