blob: 405c455b25b15013a4ecc5c6cfdac98261b6299e [file] [log] [blame]
\section{\module{cmpcache} ---
Efficient file comparisons}
\declaremodule{standard}{cmpcache}
\sectionauthor{Moshe Zadka}{mzadka@geocities.com}
\modulesynopsis{Compare files very efficiently.}
% XXX check version number before release!
\deprecated{1.5.3}{Use the \module{filecmp} module instead.}
The \module{cmpcache} module provides an identical interface and similar
functionality as the \refmodule{cmp} module, but can be a bit more efficient
as it uses \function{statcache.stat()} instead of \function{os.stat()}
(see the \refmodule{statcache} module for information on the
difference).
\strong{Note:} Using the \refmodule{statcache} module to provide
\function{stat()} information results in trashing the cache
invalidation mechanism: results are not as reliable. To ensure
``current'' results, use \function{cmp.cmp()} instead of the version
defined in this module, or use \function{statcache.forget()} to
invalidate the appropriate entries.