view Doc/lib/libcmpcache.tex @ 32527:0da660e05e69 legacy-trunk

"#if WITH_THREAD" is incorrect; must be #ifdef instead; WITH_THREAD isn't always set to an integer value when it's defined.
author Tim Peters <tim.peters@gmail.com>
date Wed, 07 Jul 2004 20:42:07 +0000
parents 376ee174ecd0
children
line wrap: on
line source

\section{\module{cmpcache} ---
         Efficient file comparisons}

\declaremodule{standard}{cmpcache}
\sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}
\modulesynopsis{Compare files very efficiently.}

\deprecated{1.6}{Use the \refmodule{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).

\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.}