Mercurial > cpython-lru_cache-weakref

annotate Doc/lib/libcmpcache.tex @ 15164:8930ec3bc00a legacy-trunk

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added additional test cases for pulldom modifications.
author Lars Gustäbel <lars@gustaebel.de>
date Wed, 11 Oct 2000 22:36:00 +0000
parents c8155d05d9ca
children d7864345b1c8
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}
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
5 \sectionauthor{Moshe Zadka}{mzadka@geocities.com}
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
11414
c8155d05d9ca Added deprecation notes, in case anyone decides to read these anyway.
Fred Drake <fdrake@acm.org>
parents: 11005
diff changeset
8 % XXX check version number before release!
c8155d05d9ca Added deprecation notes, in case anyone decides to read these anyway.
Fred Drake <fdrake@acm.org>
parents: 11005
diff changeset
9 \deprecated{1.5.3}{Use the \module{filecmp} module instead.}
c8155d05d9ca Added deprecation notes, in case anyone decides to read these anyway.
Fred Drake <fdrake@acm.org>
parents: 11005
diff changeset
10
11005
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
11 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
12 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
13 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
14 (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
15 difference).
10996
84ab14d85763 New module documentation sections from Moshe Zadka <moshez@math.huji.ac.il>!
Fred Drake <fdrake@acm.org>
parents:
diff changeset
16
11005
c8ed5a14488d Updated version from Moshe, with a re-written warning about the
Fred Drake <fdrake@acm.org>
parents: 10996
diff changeset
17 \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
18 \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
19 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
20 ``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
21 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
22 invalidate the appropriate entries.