Ditched '_find_SET()', since it was a no-value-added wrapper around
[python/dscho.git] / Doc / lib / libcmpcache.tex
blob405c455b25b15013a4ecc5c6cfdac98261b6299e
1 \section{\module{cmpcache} ---
2 Efficient file comparisons}
4 \declaremodule{standard}{cmpcache}
5 \sectionauthor{Moshe Zadka}{mzadka@geocities.com}
6 \modulesynopsis{Compare files very efficiently.}
8 % XXX check version number before release!
9 \deprecated{1.5.3}{Use the \module{filecmp} module instead.}
11 The \module{cmpcache} module provides an identical interface and similar
12 functionality as the \refmodule{cmp} module, but can be a bit more efficient
13 as it uses \function{statcache.stat()} instead of \function{os.stat()}
14 (see the \refmodule{statcache} module for information on the
15 difference).
17 \strong{Note:} Using the \refmodule{statcache} module to provide
18 \function{stat()} information results in trashing the cache
19 invalidation mechanism: results are not as reliable. To ensure
20 ``current'' results, use \function{cmp.cmp()} instead of the version
21 defined in this module, or use \function{statcache.forget()} to
22 invalidate the appropriate entries.